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: token-efficient, concrete at every step, with an approval gate and an explicit validation criterion ('a new check must fail on the old state when practical'). The fix ladder is a genuinely useful decision structure, and the Stop section covers the missing-evidence and ownership-boundary failure modes.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~35-line body is lean and every line instructs (rules, fix ladder, workflow, stop conditions); the only explanatory line ("Not a status summary: use `session-compact` for handoff state") is a useful disambiguation, not padding. No explanation of concepts Claude already knows — matches anchor 5. | 5 / 5 |
Actionability | Concrete, executable guidance throughout: exact fix-ladder rungs ("test, lint rule, hook, CI check" / "script, template, default config" / "skill, `AGENTS.md` / `CLAUDE.md`"), specific evidence commands (`git log` and diff, hook/CI failures, `task` evidence), exact record fields, and named tools (`verify`, `session-compact`, `dev-debug`). Per the rubric's code-vs-instruction note, an instruction-only skill with this level of specific guidance earns the top anchor. | 5 / 5 |
Workflow Clarity | Six clearly sequenced steps with explicit validation checkpoints: "Present the items and wait for approval", and "validate each with `verify` (a new check must fail on the old state when practical)" — an explicit feedback criterion. The Stop section adds error-recovery/pause conditions and handoff. Matches anchor 5's clear sequence with explicit validation and error handling. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines, self-contained with no bundle files, and organized into clear sections (Rules, Fix Ladder, Workflow, Stop). The rubric's simple-skill exception applies: well-organized sections suffice for a 5 when there is no need for external references. | 5 / 5 |
Total | 20 / 20 Passed |