Content
71%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.
The body is an efficiently written, well-sequenced instruction set with concrete paths, explicit validation checkpoints, and strong safety gates around destructive operations. Its main weaknesses are navigation and self-containment: most bundle reference files are never linked from the body, and a few compressed sentences lean on terms (spec modes, ref-11 controls) defined only in those unlinked files.
Suggestions
Link every bundle file from the body at its point of use — e.g. P1 → references/01-analysis.md, P5 → references/12-verify-report.md, upgrade → references/10-upgrade.md — so all 13 references and scripts/scope-guard.sh are discoverable from SKILL.md.
Define or drop undefined shorthand like "both spec modes" and "the three ref-11 controls", or point directly to the reference that defines them.
Add a short failure-handling branch to P5 (what to do when verification or idempotence checks fail) to close the workflow's missing feedback loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with instructions and contains no padding, no explanations of concepts Claude already knows, and no fluff — e.g. the mode table delivers one line per mode. It falls short of 5 due to minor redundancy ("never create or mirror it under another assistant namespace" and "do not create a duplicate board under another assistant namespace" repeat the same rule) and a few over-compressed sentences such as "The three ref-11 controls and task Methodology/Anti-drift cron sections are ungated in both spec modes", where "both spec modes" is never defined in the body. | 4 / 5 |
Actionability | Mostly concrete: exact artifact paths (`.codex/agents/task-tracker.toml`, `.codex/features/board.md`, `TASK_TEMPLATE.md`, etc.), a precise mode-resolution rule with an explicit alias blacklist, and template pointers for the generation phases. Not 5 because the P1 analysis step ("Analyze repository domains, documentation, release conventions") stays high-level and its how-to lives in `references/01-analysis.md`, which the body never links, and the verification step similarly never points to its detail file. | 4 / 5 |
Workflow Clarity | The P0→P5.5 phases are clearly sequenced with explicit validation: step 7 verifies "paths, TOML, skill frontmatter, folder/status invariants, board counts, link integrity, and idempotence", destructive modes confirm first with task counts and an `uninstall` alternative, and "run the `status` inventory afterwards as the proof" adds a post-action checkpoint. Not 5 because there is no error-recovery feedback loop telling Claude what to do when verification fails. | 4 / 5 |
Progressive Disclosure | The body is a lean overview that appropriately pushes detail into reference files and clearly signals three of them (references/02, 03, 11 — all real files), but 10 of the 13 bundle files (01, 04–10, 12, 13) and scripts/scope-guard.sh are never mentioned anywhere in the body, and reference files chain to each other (ref 03 cites "ref 11" and "ref 05"), leaving most of the bundle unreachable by explicit navigation from SKILL.md. This matches the 'references present but not clearly signaled' anchor better than score 4's 'minor organization gaps'. | 3 / 5 |
Total | 15 / 20 Passed |