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 well-structured instruction-only skill: an analysis-first workflow with hard rules, an anti-rationalization table, validation gates, and correctly externalized detail in a single one-level-deep reference. Scores hold at 4 rather than 5 only for minor gaps: slight rule duplication across sections, no worked before/after example, and no explicit error-recovery loop when validation fails.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and prescriptive with almost no explanation of concepts Claude already knows; every section is actionable rules. Minor duplication exists (the force-fit rule and the parallel-change rule each appear in both Hard Rules and the Red Flags table), which is anchor 4's "minor instances that could be trimmed" rather than anchor 5's every-token-earns-its-place. | 4 / 5 |
Actionability | It includes an executable command ("npx ai-devkit@latest memory search --query \"<target area>\" --tags \"simplify\""), concrete decision tools (existence check, reader-load test), eight named patterns, and a concrete dev-smoke gate. It stops short of anchor 5 because there is no worked before/after example or copy-paste-ready snippet demonstrating the common case. | 4 / 5 |
Workflow Clarity | The five-step workflow (Gather Context → Analyze → Apply Readability Principles → Propose → Prioritize and Plan) is clearly sequenced, with an approval checkpoint ("Do not modify code until the user approves a simplification plan") and validation steps ("run dev-smoke before and after; results must match"). It misses anchor 5's explicit error-recovery feedback loop for when validation fails or smoke results diverge. | 4 / 5 |
Progressive Disclosure | The body is a well-organized overview whose single deep-dive (readability heuristics) is correctly split into references/readability-guide.md, clearly signaled as "Apply the [readability guide](references/readability-guide.md) and its 'Reading Test'" — a real file, one level deep, with no buried or nested references. This matches anchor 5 exactly. | 5 / 5 |
Total | 17 / 20 Passed |