Content
100%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured instruction skill: concise, highly actionable, with a clear phased workflow and properly disclosed references. All dimensions land at the top of the scale.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean body that assumes Claude's competence; no padding explaining basic concepts, and the 'Learn More' pointer is purposeful and minimal. Every section earns its place. | 3 / 3 |
Actionability | Concrete phases, named tool calls (ToolSearch, AskUserQuestion), real file paths, and explicit rules ('two rounds of pushback per section maximum'). Specific, executable guidance throughout. | 3 / 3 |
Workflow Clarity | Phases 0-3 are clearly sequenced with explicit routing by file state, validation checkpoints (pushback rounds, present draft before writing, edit offer), and feedback for error recovery. Not a 2: checkpoints are explicit, not implicit. | 3 / 3 |
Progressive Disclosure | SKILL.md is an overview with well-signaled, one-level-deep references (references/interview.md, references/strategy-template.md), both verified to exist. Content is appropriately split with easy navigation. | 3 / 3 |
Total | 12 / 12 Passed |