Content
78%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 lean, well-structured, highly actionable instruction skill: concrete persona, grounding requirements, templates, validation-as-findings, and hard rules, with no padding. Its critical defect is bundle completeness — all four rules/ files (the three mode taxonomies and the deep-mode procedure) referenced by the body are missing from the bundle, breaking both the core procedure and the progressive-disclosure structure.
Suggestions
Ship the four missing rules/ files (taxonomy-plan.md, taxonomy-code.md, taxonomy-analysis.md, deep-mode.md) in the bundle — they carry the core failure taxonomy and deep-mode procedure that the body's 'Walk the failure taxonomy' and deep-mode steps depend on.
Add a short consolidated numbered run sequence (parse arguments → state mode → persona → grounding → taxonomy walk → steelman → output) so the workflow order does not have to be assembled from separate sections.
If the rules/ files are intentionally kept out of some distributions, inline a minimal per-mode taxonomy summary in the body so a run degrades gracefully instead of hitting dead references.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and efficient throughout: no concept explanations Claude already knows, rationale offloaded to "references/why-single-pass.md", and every section carries operational weight (mode table, persona contract, grounding actions, steelman template, output format, hard rules). The apparent duplication between persona rules and hard rules 4/6 is handled via explicit cross-references ("(persona rule 2)"), not restated content, so it sits at anchor 5 rather than anchor 4's 'minor instances that could be trimmed'. | 5 / 5 |
Actionability | Highly concrete guidance: verbatim persona blockquote, exact mode-declaration line ("Mode: critical/<mode>. Target: <one-line summary>."), per-mode grounding commands ("`Read` the `plan.md`; `grep` for at least two referenced files/symbols"), and a copy-paste output template with classification definitions. It stops short of anchor 5 because the taxonomy walk — the core procedure — depends on "rules/taxonomy-plan.md", "rules/taxonomy-code.md", "rules/taxonomy-analysis.md", and "rules/deep-mode.md", none of which exist in the bundle, so the run cannot actually execute that step as delivered; this is more than the 'covers the common cases' bar of anchor 5 but the in-body guidance itself is fully executable, above anchor 3. | 4 / 5 |
Workflow Clarity | The sequence is clear and ordered by signal phrases ("State the detected mode in one line before running", "Before writing the findings, run at least one grounding action", "Walk the failure taxonomy", output format last) and includes real validation checkpoints — grounding failures escalate to must-fix findings ("A referenced file, symbol, or path that does not resolve is itself a `must-fix` finding") and "Skipped rows are listed, never skipped silently". It is not anchor 5 because there is no single consolidated ordered step list; the run order must be assembled from several sections, a minor gap versus anchor 5's explicit checklists. | 4 / 5 |
Progressive Disclosure | The design is anchor-5 quality — a concise overview with well-signaled, one-level-deep references, each annotated with its contents ("procedure, lens catalog, single-context fallback, sub-agent prompt contract, synthesis, and output format") — but scored against the actual bundle, 4 of the 5 referenced paths (all four "rules/*.md" files) do not exist; only "references/why-single-pass.md" resolves. Since the primary disclosure mechanism (offloading taxonomy and deep-mode detail to rules files) is broken in the delivered bundle, it cannot score above anchor 3's 'some structure' despite excellent signaling. | 3 / 5 |
Total | 16 / 20 Passed |