claude-hook-validation
Files
SKILL.mdagentsreferences
Install
Install only this skill with npx skills
npx skills add alisonaquinas/llm-shared-skills --skill 'claude-hook-validation' -g -y
Install the containing skill bundle
/plugin install shared-skills@llm-skills
This skill is bundled inside shared-skills. Use
npx skills when you only want this skill, or install the bundle once to make every included skill available through the plugin marketplace flow. Browse the full skill bundle repository at github.com/alisonaquinas/llm-shared-skills.Invoke
Invoke this skill after installation
/shared-skills:claude-hook-validation
SKILL.md
name: claude-hook-validation description: > Validation phase for hook automation rule development. Use when planning, designing, building, testing, validating, or refining a hook automation rule as it moves through a full delivery lifecycle. Triggers include drafting the hook spec, locking contracts, wiring runtime placement, scoring quality, running live scenarios, or choosing the right re-entry point after a failure.
Hook Validation
Score quality, discoverability, safety, and portability before the rule is considered release-ready.
Intent Router
Load reference files on demand only when the corresponding topic is active:
references/quality-rubric.md— Load when scoring safety, observability, and portability
Quick Start
[ ] Capture the current hook spec
[ ] Complete the required outputs for this phase
[ ] Record evidence for the gate
[ ] Hand off the evidence to the next phase
Phase Workflow
Start from the current hook spec and tighten only the decisions owned by this phase. Work forward until the gate is satisfied, then hand the evidence to the next phase in the family. Keep the workflow description portable even when the runtime wiring is specific to one environment.
Example Evidence
| Criterion | Score | Notes |
|---|---|---|
| Discoverability | PASS | |
| Safety | PASS | |
| Observability | PASS | |
| Portability | PASS | |
Gate
Require H04 Safety to PASS before approving the hook automation rule.
Safety Notes
A rule that fails safety or portability validation must loop back before any live rollout.
Resource Index
| Reference File | Load When |
|---|---|
references/quality-rubric.md | Load when scoring safety, observability, and portability |