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, assumption-free of Claude's knowledge, fully executable commands, a well-sequenced workflow with dry-run validation and recovery loops, and a clean overview-plus-references split. The only stylistic quibble — rule 7's step-conditional phrasing about pre/post-install runners — is essential non-obvious detail, not padding.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~45-line body is pure instruction with zero concept explanations Claude already knows; every sentence adds non-obvious operational detail ("Codex runs the hook only after the user trusts it in /hooks", "Before step 3, Fallow is not installed"), matching the lean 'every token earns its place' anchor rather than the 4 anchor's trimmable instances. | 5 / 5 |
Actionability | Exact executable commands with flags throughout — `fallow recommend --format json --quiet`, `npx fallow recommend`, `pnpm add -D fallow`, `fallow agent install --dry-run --format json --quiet`, `fallow agent status --format json --quiet` — plus named tools (Oxfmt, Oxlint, `tsc --noEmit`, Knip, jscpd, dependency-cruiser). Per the rubric's scoring note, an instruction-only skill needs actionable guidance, and this is copy-paste ready. | 5 / 5 |
Workflow Clarity | A clear six-step sequence with explicit validation checkpoints: dry-run then show plan then execute for the mutating agent install, `fallow agent status` verification, a parity check before removing an overlapping tool, and an error-recovery feedback loop ("When the first run has many findings, save a baseline... so that the gate fails only on new findings") plus explicit escalation tiers (apply auto, tell default, ask taste). | 5 / 5 |
Progressive Disclosure | The body is a concise overview with three real one-level-deep reference files (references/tooling-detection.md, configure-and-install.md, ci-gate.md — all present, no deeper nesting), each linked inline where used in the sequence and described in a dedicated References section, making navigation easy exactly as the top anchor describes. | 5 / 5 |
Total | 20 / 20 Passed |