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: lean and aphoristic, fully executable against the real codebase, with a well-sequenced destructive-edit workflow gated by an explicit validation checklist, and a single appropriately placed reference file for campaign-mode detail. No dimension shows more than negligible room for improvement.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and prescriptive with zero padding: every line carries project-specific guidance ("A regression test that never demonstrably failed proves the mock, not the fix") and nothing explains concepts Claude already knows. It fully matches the lean, every-token-earns-its-place anchor. | 5 / 5 |
Actionability | Fully executable instruction-only guidance: concrete commands (`pnpm --filter <package> exec vitest --run <path-or-filter>`, `tsx --test <file>`, `--coverage` before/after, `oxfmt`, `git diff --check`, `pnpm test:fast`, `pnpm guard:<name>`, `.changeset/*.md`), a 17-item concrete junk-pattern checklist, and a four-question authoring gate with explicit failure conditions. Copy-paste ready for this codebase. | 5 / 5 |
Workflow Clarity | A clearly sequenced pipeline (authoring gate → junk patterns → value bar → discovery → retention bar → candidate evidence → edit shape → validation → landing → handoff) with explicit checkpoints ("Record every field below before editing. A missing field means the candidate is not ready") and a 7-step numbered validation checklist with feedback loops such as before/after coverage comparison and reproducing baseline failures instead of deleting them. Destructive/batch edits are gated by validation, so no cap applies. | 5 / 5 |
Progressive Disclosure | Against the actual bundle: one well-signaled, one-level-deep reference (`references/campaign.md`, verified to exist and link only back to ../SKILL.md) introduced exactly at the point of need ("before starting one, read [references/campaign.md]"), while shared value-bar, retention, and validation content is correctly kept inline. Clear overview, appropriate split, easy navigation. | 5 / 5 |
Total | 20 / 20 Passed |