Example Hook Backed Skill

Goal: create a skill that enforces a deterministic check at a specific lifecycle or tool boundary.

Input collection approach

This case collected:

1. official hook lifecycle and schema docs
2. security guidance for shell-executed hooks
3. examples of narrow matchers vs over-broad hooks
4. fallback behavior for environments without hooks

Coverage matrix used

Required dimensions tracked during synthesis:

1. event and matcher scope
2. decision behavior
3. security boundaries
4. fallback behavior
5. portability constraints

Synthesized artifacts produced

The resulting skill references included:

1. hook configuration example
2. safety checklist
3. fallback path without hooks
4. anti-pattern showing over-broad or unsafe hook scope

What made this high quality

1. the hook scope was narrow and auditable
2. security assumptions were explicit
3. the skill still described what to do when hooks were unavailable