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 instruction-only skill body: concrete commands, exact constraints, a validate-and-retry feedback loop, and correctly used one-level-deep bundle files. The only flaw is a small duplicated error-handling bullet that restate Step 3's line-limit rule.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean, assumes Claude's competence, and never explains concepts Claude already knows, but the 'Context Bloat' error-handling bullet duplicates Step 3's under-500-lines/move-to-references rule. This matches 'efficient; minor instances of over-explanation that could be trimmed' rather than 5 ('every token earns its place') and is well above 3. | 4 / 5 |
Actionability | Guidance is fully executable: a copy-paste-ready command ('python scripts/validate-metadata.py --name "[name]" --description "[description]"'), exact constraints (1-64 chars, max 1,024 characters, under 500 lines), concrete file paths, and a template starting point in assets/SKILL.template.md. Per the scoring notes, an instruction-only skill with this level of concrete guidance earns the top anchor. | 5 / 5 |
Workflow Clarity | The five steps are clearly sequenced with an explicit validation feedback loop (run the script, self-correct from stderr, re-run until successful) and a final cross-reference against references/checklist.md. This matches 'clear sequence with explicit validation steps; feedback loops for error recovery; checklists'. | 5 / 5 |
Progressive Disclosure | All referenced bundle files (scripts/validate-metadata.py, references/checklist.md, assets/SKILL.template.md) exist and are one level deep, each invoked at the exact point of need with its purpose stated. The body itself models progressive disclosure by directing large schemas/rules to references/ with targeted read commands, matching 'well-signaled one-level-deep references; content appropriately split'. | 5 / 5 |
Total | 19 / 20 Passed |