Content
92%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.
An exemplary lean instruction-only skill body: fully actionable behavioral directives with a clear termination condition and no padding. The only improvement space is defining the end-of-interview output and optionally one example question.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Four lean sentences, every one a directive, with zero padding and no explanations of concepts Claude already knows. The body adds behavior the description alone doesn't fully specify (one-at-a-time, recommendation per question, codebase-first), so every token earns its place — anchor 5, not 4, since nothing could be trimmed. | 5 / 5 |
Actionability | 'Ask the questions one at a time', 'For each question, provide your recommended answer', and 'If a question can be answered by exploring the codebase, explore the codebase instead' are concrete, unambiguous directives. Minor gaps keep it below anchor 5: no example question illustrating the desired depth, and no stated end-of-interview deliverable (e.g., summarize the resolved decisions). | 4 / 5 |
Workflow Clarity | A single-purpose skill under 50 lines with an unambiguous loop — one question at a time, recommendation each round, resolve each branch — and an explicit termination condition ('until we reach a shared understanding'). No destructive or batch operations, so no validation cap applies; the simple-skill exception makes this a clear anchor 5. | 5 / 5 |
Progressive Disclosure | Under 50 lines with no need for external references — no bundle files exist and none are referenced, correctly. At four sentences the content is trivially well-organized; per the under-50-lines guideline this is anchor 5, not 4, since there is nothing that should be split out. | 5 / 5 |
Total | 19 / 20 Passed |