Content
68%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 well-disciplined delegating skill: a short overview body, real one-level-deep reference files, and repo-specific rules that only the repo could teach (doc/ vs specs/ handling). The main weaknesses are the absence of any output-validation checkpoint in the execution workflow, duplication between the Source-of-truth list and the command catalog, and one orphaned reference file.
Suggestions
Add a validation step to Execution rules, e.g. 'Before finishing, verify the output includes every required field defined in the template' — this directly lifts workflow_clarity past level 3.
Reference `references/source-commands.md` from the body (or note what it is for) so the 20KB file is not an unreachable orphan in the bundle.
Collapse the 'Source of truth' bullet list into the command catalog (or vice versa) so the same 11 file paths are not maintained in two places.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 46-line body is lean and assumes Claude's competence — no concept explanations, no filler — and lines like the `doc/` vs `specs/` commit rule add genuinely non-obvious repo knowledge. It falls short of 5 because the 11-file 'Source of truth' bullet list substantially duplicates the per-command file mapping in `references/command-catalog.md` and could be collapsed into a single pointer. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is concrete: it names the exact reference file to read, defines the output contract ('apply the template structure and required fields'), and gives specific repo locations (`doc/`, `specs/`, `AGENTS.md` section `<internal_dirs>`). Minor gaps keep it below 5 — no guidance on picking a template when a request matches multiple commands, and 'Command mapping' delegates wholesale to `command-catalog.md` rather than giving one inline example. | 4 / 5 |
Workflow Clarity | Execution rules give a usable sequence (read template → apply structure → keep edits minimal/locations), and the 'never commit specs/' warning is a real guardrail, but there is no validation checkpoint — nothing like 'confirm the output contains every required field from the template before finishing'. That matches 'steps listed but validation gaps' rather than level 4's 'most checkpoints present'. | 3 / 5 |
Progressive Disclosure | Scored against the actual bundle: every referenced path in the body exists in `references/`, references are one level deep and clearly signaled under 'Source of truth', and the body is a genuine overview rather than a wall of text. Two minor gaps hold it at 4: `references/source-commands.md` (20KB) is an orphan — never referenced or navigable from the body — and reaching a template via 'Command mapping' requires a double hop (body → command-catalog.md → reference file). | 4 / 5 |
Total | 15 / 20 Passed |