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.
The body is a tight, actionable instruction skill: an exhaustive decision tree with exact path templates, a concrete output format, and unusually good failure-mode handling. Its one structural weakness is that key supplemental content (full filing rules, notability gate, operator protocol) lives in files outside the skill bundle, so a standalone reader cannot follow the references.
Suggestions
Ship the referenced files inside the skill's references/ directory (or inline the notability gate criteria) so phases 4 and the failure fallbacks are self-contained.
Make the "Cross-link" phase concrete — specify which related directories to link from and the link format to use.
Promote "check if a page already exists" from an anti-pattern into an explicit phase step, since the anti-patterns section calls it out but the workflow never instructs it.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean — decision tree, output template, failure handling, and anti-patterns all earn their tokens, with no explanations of concepts Claude already knows. The "Contract" section mildly duplicates the description and the Phases/Anti-Patterns content, which is trimmable, keeping it just below a 5. | 4 / 5 |
Actionability | Highly concrete for an instruction-only skill: exact path templates (e.g., "people/{name-slug}.md", "media/{type}/{slug}.md"), a copy-paste output sentence, and specific error codes ("page_not_found") with recovery actions. The "Cross-link. Link from related directories." step is vague about method and targets, a minor gap that prevents a 5. | 4 / 5 |
Workflow Clarity | A clear four-phase sequence with an explicit validation gate (step 4 notability check) and a "When it fails" section providing concrete error-recovery feedback loops. The "check if a page already exists" validation is only stated as an anti-pattern rather than an explicit phase step, a minor gap that prevents a 5. | 4 / 5 |
Progressive Disclosure | Sections are well organized and references are clearly signaled (blockquote pointer, inline step references, failure-section link), with the core decision tree properly inline. However, the referenced files ("skills/_brain-filing-rules.md", "skills/conventions/quality.md", "../conventions/agent-operator-protocol.md") are not present in the skill bundle — no references/ directory exists — so the navigation dangles and the notability gate depends entirely on an unreachable external file. | 3 / 5 |
Total | 15 / 20 Passed |