Content
60%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 SKILL.md body is well-designed as a thin, mode-routed index with lean tables, explicit gates, and per-mode completion checklists, and its workflow sequencing is solid. However, its entire progressive-disclosure promise is unfulfilled in this bundle: the rules/ and templates/ files it instructs Claude to load do not exist, leaving most mode detail inaccessible and one bundled reference (research-sources.md) orphaned.
Suggestions
Ship the rules/ and templates/ files the body depends on (content-routing.md, placement-resolver.md, drift-detection.md, claude-md.md, readme.md, docs-folder.md, writing-style.md, maintenance.md, auto-update-loop.md, and the templates) — or inline the essential rules into SKILL.md if the bundle is meant to be single-file.
Link references/research-sources.md from the body (e.g., from Core Principles or a Sources section) so the one extra bundled file is discoverable and its role is stated, matching how archetypes.md is referenced.
Deduplicate the init hard rules from the Definition of Done checklists (and the mode table from the disambiguation list) so each rule appears once, trimming the body's token cost without losing the closing gates.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Largely lean and prescriptive — mode-routing tables, argument tables, numbered phases, and one-liner anti-patterns rather than concept tutorials — but there is duplication: the init hard rules reappear in the Definition of Done checklists, the mode table plus the disambiguation list state the routing twice, and Core Principles restate routing rationale already given in mode sections. Not 5: these repeated blocks are tokens that could be trimmed; not 3: the padding is minor and the tone consistently assumes Claude's competence (e.g., no explanation of what git or markdown is). | 4 / 5 |
Actionability | Some concrete guidance exists in-body — "CLAUDE.md ≤ 200 lines", "ln -s CLAUDE.md AGENTS.md", badge-count limits, AskUserQuestion options, dry-run flag, P0/P1/P2 tiers — but the executable meat of every mode is deferred to files that are not in the bundle: "see rules/drift-detection.md §1 for git diff commands", the Content Routing Rubric, the Placement Resolver algorithm, the mandatory README section order, and all templates/*.md skeletons are all missing. Not 4: the gaps are not minor — a run of any mode would stall at the first "load rules/X.md" instruction; not 2: the body still delivers specific routing, budgets, and gates that can be acted on alone. | 3 / 5 |
Workflow Clarity | Each mode has a numbered phase sequence with checkpoints: init gates on AskUserQuestion before overwriting, update offers dry-run and asks confirmation for P1 items, audit is declared read-only, and every mode closes with a Definition of Done checklist ("Treat any unchecked item as a defect") including verification items like "Every @import added resolves to a real file" and "Every relative link resolves". Not 5: several checkpoints are implicit or underspecified in-body (drift-detection commands, README rubric scoring procedure) because the detail lives in absent rule files; not 3: explicit checklists and confirmation gates are present for the batch-write update flow, so the destructive/batch cap does not apply. | 4 / 5 |
Progressive Disclosure | Scored against the actual bundle: the body declares itself "a thin index" pointing to rules/*.md (9 referenced files) and templates/*.md, but neither directory exists — only references/archetypes.md is present, so ~10 of 11 referenced paths are broken, and references/research-sources.md exists yet is never linked from the body. Not 3: the in-body structure and reference signaling are excellent on paper, but navigation to any detailed material is dead, and one bundled file is undiscoverable; not 1: the body itself is well-sectioned and contains substantial standalone guidance rather than being unnavigable. | 2 / 5 |
Total | 13 / 20 Passed |