Content
86%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A strong, highly actionable body: executable settings JSON and script templates, concrete verification and troubleshooting steps, and exemplary progressive disclosure to real reference files. The main gaps are minor — a scattered (rather than consolidated) end-to-end workflow and a couple of sections (Common Matchers, Wildcard Permissions) that restate basics or belong in a reference.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is table- and code-driven with almost no conceptual padding — exit codes, events, and file locations are compressed into tables, and the bash template is minimal. It falls short of anchor 5 because "Common Matchers" spells out basics Claude already knows (Bash, Edit, Grep) and the "Wildcard Permissions" detail would fit better in a reference file. Not 3, since the padding is minor rather than a section-length problem. | 4 / 5 |
Actionability | Fully executable throughout: a complete settings JSON structure, a copy-paste bash template with jq input parsing and a working exit-2 block pattern, exact commands (`/hooks`, `claude --debug`, `cat .claude/settings.json | jq .`), and three concrete example files (firewall, quality checks, pre-push tests) covering the common cases — matching anchor 5. | 5 / 5 |
Workflow Clarity | "Testing Hooks Safely" is a 4-step sequence with an explicit verify step, and "Verifying Hooks Are Loaded" is a concrete checklist, but there is no single end-to-end create-hook sequence (write script → chmod +x → register in settings → restart → verify); the steps are scattered across sections and `chmod` appears only as a parenthetical. This matches anchor 4 (clear sequence, most checkpoints, minor gaps); the skill is not destructive/batch, so no cap applies. | 4 / 5 |
Progressive Disclosure | The body is an overview with a clearly signaled "You MUST read the reference files" section pointing to four real, one-level-deep files (hook-events.md plus three examples), each annotated with what it contains. Detailed schemas and full examples are correctly kept out of SKILL.md, matching anchor 5 (well-signaled one-level-deep references, easy navigation). | 5 / 5 |
Total | 18 / 20 Passed |