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: a tightly sequenced implement-prove-report workflow with explicit validation checkpoints, concrete file paths, and a copy-paste output contract, with detail correctly pushed to a one-level-deep playbook reference. The only imperfection is minor elision in one command path and the absence of a worked manifest example.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, imperative directives with zero padding — "Implement one task. Keep the change no larger than the task's observable outcome requires." — and no explanation of concepts Claude already knows (no TDD tutorials, no git basics). Every line is either a directive, a boundary, or part of the required output contract, matching the lean anchor 5 rather than anchor 4 where trimming would still find fat. | 5 / 5 |
Actionability | Guidance is highly concrete: exact file paths (`.factory/CONTEXT.md`, `.factory/evidence/<ticket>/<task>/manifest.json`), explicit manifest fields, a copy-paste output template, and exact status values (`ready_for_review`). It falls short of anchor 5 on small gaps: the state command is elided ("`node …/factory-supervise/scripts/fstate/cli.mjs`") and the manifest is specified by field list rather than by a worked example, but it is far above anchor 3's pseudocode level. | 4 / 5 |
Workflow Clarity | The sequence is explicit and checkpointed: contract establishment with dependency/share gating, a numbered proving-slice loop that requires confirming the test "fails for the expected reason", explicit artifact proof ("A compile, typecheck, file timestamp, or self-report is not proof"), and an error-recovery loop ("If implementation repeatedly fights the sketch, stop... and redesign") plus plan-conflict escalation. This matches anchor 5's clear sequence with validation steps and feedback loops; no destructive/batch cap applies. | 5 / 5 |
Progressive Disclosure | The body is a concise orchestration overview that keeps the four task playbooks in a clearly signaled one-level-deep reference ([references/playbooks.md](references/playbooks.md), verified present) and delegates proof procedure to a single clearly linked sibling skill ([../prove-it-works/SKILL.md](../prove-it-works/SKILL.md)). The split is appropriate — the per-task playbook detail and verification procedure stay out of the main file, and the inline output template is the per-run contract, matching anchor 5. | 5 / 5 |
Total | 19 / 20 Passed |