Content
88%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 an exemplary instruction-only skill: concrete bad/good pairs for every required section, a verifiable audit checklist with a revise-on-failure loop, and well-organized anti-pattern guidance with fixes. Its only real gaps are minor redundancy between the section templates and the audit rubric, and cross-references that are named but not linked as navigable pointers.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, checklist-style guidance ("Replace broad 'ask the user' language with explicit choices"; "no `<...>`, 'TBD', 'TODO'") with no padding explaining concepts Claude already knows. Not a 5 because completion criteria, fallback behavior, and response format each appear twice — once in the section templates and again in the audit rubric — which could be tightened into a single cross-referenced list. | 4 / 5 |
Actionability | Every required section ships with concrete Bad/Good example pairs ("Bad: 'You are a helpful AI assistant.' / Good: 'You are Acme's Tier-1 Email Triager...'") plus a copy-paste-ready completion-criteria template and an 11-item checkable audit list. Per the rubric's scoring note, an instruction-only skill without code is not penalized when the guidance is this actionable, matching the top anchor. | 5 / 5 |
Workflow Clarity | The sequence is explicit — numbered run contract (1–6), nine named sections, then a mandatory audit rubric with the feedback loop "If any item fails, revise the system prompt before writing it" — and "How to use this skill" adds a four-step path for the novel-outcome case. This is prompt authoring, not a destructive/batch operation, so no cap applies; the checklist-plus-retry structure matches the 5 anchor. | 5 / 5 |
Progressive Disclosure | No bundle files exist, and the single-file body is well-sectioned with clear headers while domain detail is correctly externalized to the archetype skills. Below 5 because the "Cross-references" section names sibling skills (coding-agent, research-agent, ...) as plain text rather than signaling them as navigable references, and the file exceeds the under-50-line simple-skill exception. | 4 / 5 |
Total | 18 / 20 Passed |