Content
77%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 a tightly written, checklist-driven adversarial procedure with an explicit output contract, a grounding validation step, and clear mode handling — workflow clarity and actionability for the standard path are excellent. The two real weaknesses are a broken reference (rules/deep-mode.md does not exist in the bundle, leaving deep mode under-specified) and modest rule repetition across sections.
Suggestions
Fix the broken reference: either add the actual rules/deep-mode.md file (with the lens catalog, sub-agent prompt contract, and deep output format the body promises) or inline a minimal fallback lens catalog and sub-agent prompt so deep mode is fully executable from the bundle as shipped.
Deduplicate the repeated hard rules: state the one-pass, every-finding-cites, and no-re-stating rules once (in 'Hard rules and non-goals') and reference them from the persona contract, intro, and output format instead of restating them in each place.
The argument-hint advertises '--lenses <n|a,b-c>' but no section in SKILL.md explains how lens count or named lenses are selected; document that where deep mode is defined.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and table-driven with essentially no explanation of concepts Claude already knows — the taxonomies, persona blockquote, and output template all earn their tokens. It is not a 5 because several rules are repeated across sections: the single-pass rule appears in the intro, hard rule 1, and the output format; the citation rule appears in both the persona contract and hard rule 4; the no-restatement rule appears as persona rule 3 and hard rule 6. Consolidating these would trim a modest number of tokens without loss. It is not a 3 because beyond this redundancy the content is efficient and assumes the model's competence. | 4 / 5 |
Actionability | The core run is copy-paste executable: the exact persona text to adopt, the mode-announcement line ("Mode: critical/<mode>. Target: <one-line summary>."), the full output-format markdown template, per-mode grounding actions ("Read the plan.md; grep for at least two referenced files/symbols"), and classification definitions for must-fix/should-fix/nice-to-have. It is not a 5 because deep mode defers its "full procedure, lens catalog, sub-agent prompt contract, and output format" to rules/deep-mode.md, and that file does not exist in the bundle — the fallback lens catalog and sub-agent prompt are therefore unavailable, leaving the deep path under-specified. | 4 / 5 |
Workflow Clarity | The sequence is clear and cued explicitly ("State the detected mode in one line before running", grounding "before writing the findings", persona "at the top of every run", ending in the "Next step" section), and validation is explicit: the external grounding rule is a checkpoint whose failure has a defined outcome ("If a referenced file, symbol, or path does not resolve, that is itself a finding (categorised as must-fix)"). The taxonomy tables are checklists (every row walked, skips must be listed), and edge cases have defined behavior ("If Must-fix and Should-fix are both empty, output 'No blocking concerns found.'"). The skill is advisory and read-only, so the destructive/batch validation cap does not apply. It is not a 4 because checkpoints and error-recovery branches are present, not missing. | 5 / 5 |
Progressive Disclosure | Scored against the actual bundle: there are no references/, scripts/, or assets/ directories, and the one path the body points to — [rules/deep-mode.md](./rules/deep-mode.md), cited twice including an anchor (#d1--lens-selection) — does not exist. The in-SKILL.md structure itself is good (a Contents TOC, well-labeled sections, clearly signaled offload), but the promised detail layer (lens catalog, sub-agent prompt contract, deep-mode output format) is neither inline nor present, so a deep-mode run hits a dead end. That is a broken disclosure path rather than a 'minor organization gap', which places it at 3 rather than 4. | 3 / 5 |
Total | 16 / 20 Passed |