Content
88%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.
An exemplarily operational skill: fully executable commands, exact outputs, sequenced phases with validation gates, verdict-driven feedback loops, and write permissions asked at each step. The only structural weakness is that everything is inlined in one long file when some templates and gate briefs could live in one-level-deep reference files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and prescriptive — exact commands, exact user-facing messages, and templates with no re-teaching of concepts Claude already knows (e.g. "Ask git, never compare two whole documents by eye" instructs rather than explains). A few spots could still be trimmed (the M=0 edge-case table rows and repeated option listings), so it is efficient with minor instances of over-explanation rather than every token earning its place. | 4 / 5 |
Actionability | Guidance is fully executable: copy-paste commands ("git diff HEAD -- design/gdd/[filename].md", "bash .claude/scripts/md-section.sh extract <adr> \"GDD Requirements Addressed\"", the md-section.sh replace heredoc), exact error/stop messages to emit, report templates, and scripted user questions cover the common cases. Absence of general-purpose code is appropriate for an instruction-only skill. | 5 / 5 |
Workflow Clarity | Ten numbered phases with explicit stop conditions ("Nothing to propagate." Stop; N=0 and M=0 branches), an explicit denominator table (N, M), a technical review gate with verdict-driven recovery loops (REJECT → "analyse the impact again first"; NOT ASSESSED → supply missing input and re-run), and permission checks before every write. Validation checkpoints are explicit throughout, including the batch ADR check. | 5 / 5 |
Progressive Disclosure | No bundle files exist; the single-file body is well organized with clear phase headers and one-level-deep, clearly signaled references to project resources (.claude/scripts/adr-status.sh, md-section.sh, .claude/docs/…). It falls short of the 5 anchor because all content — including the change-impact document template and TD gate brief — lives inline in a ~250-line monolith rather than being split across reference files. | 4 / 5 |
Total | 18 / 20 Passed |