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: lean tables instead of prose, a sequenced workflow with validation checkpoints and user-confirmation gates, and a measurable Definition of Done. Content is appropriately split into one-level-deep, well-signaled references.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is ~85 lines of pure instruction with dense tables ("| `AGENTS.md` | the pitch, tech stack, 30-second architecture... | rationale, full specs |") and zero explanation of concepts Claude already knows; even the opening triad ("Every project area has one stable home") states layout invariants in three short sentences rather than padding. | 5 / 5 |
Actionability | Instruction-only but fully concrete: explicit file ordering ("Write `invariants.md` first... and `AGENTS.md` last"), an executable lint command ("Run `prose-lint.py` on `AGENTS.md` and every file under `docs/`"), testable rules ("An internal name in a spec... is a defect"), and measurable size budgets ("`AGENTS.md` at most about 150 lines, each feature spec 5 to 15 items of 1 to 3 sentences"). | 5 / 5 |
Workflow Clarity | A clearly sequenced 5-step workflow with explicit validation (step 5: lint and "fix every finding", backed by the Definition-of-Done item "prose-lint.py reports no findings"), two user-confirmation checkpoints (steps 2 and 5), and an evidence-based checklist — the validate-fix loop for this batch file-creation skill is specified, matching the anchor-5 pattern. | 5 / 5 |
Progressive Disclosure | The body is a true overview that delegates writing rules ("../../assets/writing.md"), skeletons ("templates/"), the spec format ("templates/product-specs-README.md"), and linting ("scripts/prose-lint.py") to clearly signaled, one-level-deep references with a "Read at" timing column; nothing that belongs in a separate file is inlined. Note: the referenced bundle files were not present in the review directory to verify existence, but the written structure fully matches the anchor. | 5 / 5 |
Total | 20 / 20 Passed |