Content
100%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: three tight paragraphs that define a guard condition, a browse-read-apply procedure with a re-check trigger, and a concrete conflict-resolution rule referencing real rule fields. It respects the token budget completely and leaves nothing ambiguous about what to do.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Three lean paragraphs (~13 lines) covering no-op guard, procedure, and conflict resolution with zero padding — no concept Claude already knows is explained, and every sentence instructs. Matches the 'lean and efficient; assumes Claude's competence; every token earns its place' anchor; nothing to trim. | 5 / 5 |
Actionability | The guidance is fully executable for an instruction-only skill: it gives the exact tree layout ('`<topic>/<rule-name>.md`'), concrete actions (browse the tree, read a rule's file, meet every governing rule), the re-browse trigger, and a concrete conflict procedure referencing real rule fields ('Not-when and Cross-ref') with an explicit precedence rule (correctness/debuggability outranks style). Per the scoring notes, absence of code is not penalized when guidance is this actionable. | 5 / 5 |
Workflow Clarity | This is a simple single-purpose skill under 50 lines, and the single action is unambiguous: a guard branch ('If the repo has no `.claude/sound/` directory... do nothing'), a pre-write browse, a re-browse checkpoint when work reaches an unplanned surface, and a conflict-resolution path. Not a destructive or batch operation, so no validation feedback loop is required; the re-browse trigger serves as the checkpoint. The simple-skill exception applies cleanly. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines with no need for external references — the rule files live in the repo being edited, not in the skill bundle, so the `<topic>/<rule-name>.md` layout is itself the disclosure mechanism. Per the judging guidelines, a sub-50-line skill with no need for external references scores 5 with well-organized sections, which this has. | 5 / 5 |
Total | 20 / 20 Passed |