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.
A tightly written, well-organized instruction skill with concrete commands and a clear verify loop. Its main weakness is progressive disclosure: the body routes depth to 'reference/*.md' files that are not present in the bundled package, breaking the navigation the SKILL.md advertises.
Suggestions
Bundle the 'reference/' directory (new-work.md, craft-floor.md, routing.md, operate.md, and the per-command references) so every link in the Commands table resolves; without them, most of the skill's depth is unreachable.
Split the long compound Setup step 1 into separate lines for base-dir resolution, the Windows fallback, and the --target flag, improving scannability without adding tokens.
Clarify the '<skill-base-dir>' placeholder once up front and use a short consistent token thereafter, so repeated command examples read as directly executable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean, directive prose that assumes Claude's competence and never explains basic design concepts; a few compound sentences (e.g., Setup step 1) could be tightened, so it sits just below the anchor-5 'every token earns its place' bar. | 4 / 5 |
Actionability | Concrete, executable guidance throughout — exact commands ('impeccable context', the Commands table with per-command references), specific file loads, and explicit routing rules; minor gaps come from unresolved placeholders like '<skill-base-dir>' and '--target <path>'. | 4 / 5 |
Workflow Clarity | Clear sequenced Setup (1-2-3), a bounded-verify feedback loop ('inspect once... fix everything in one batch, confirm with at most one more round, and stop'), and explicit routing; not 5 because the workflow is routing/decision-heavy rather than a tight validate-fix-retry pipeline with checkpoints at every fragile step. | 4 / 5 |
Progressive Disclosure | The body is well-structured with a clear Commands table and clearly signaled one-level-deep references, but the 32 referenced 'reference/*.md' files are absent from the actual bundle (only 'scripts/' is present), so the promised navigation does not resolve against the real bundle structure. | 3 / 5 |
Total | 15 / 20 Passed |