Content
82%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.
A tight, well-organized instruction skill: lean token use, concrete per-folder rules with naming patterns and status flows, and clean delegation to sibling skills. The main gaps are an un-enumerated template set and the absence of validation checkpoints around status transitions.
Suggestions
List the full set of shipped template names (proposal, decision, spec/plan/tasks, postmortem, guide/onboarding-guide/runbook) in the Templates section so `write({ document: { template } })` calls are unambiguous.
Add a brief validation step before irreversible transitions (e.g., what to confirm before a proposal is accepted or a decision frozen) to strengthen the lifecycle's checkpoints.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~46-line body is lean and load-bearing: compact shape attributions ('MADR / Nygard shape', 'Google SRE shape', 'Diátaxis how-to') instead of explaining what postmortems or ADRs are, and no padded sections. It assumes Claude's competence, matching anchor 5; anchor 4 would require noticeable over-explanation that could be trimmed, which is not the case here. | 5 / 5 |
Actionability | Concrete naming patterns ('0001-feature-name.md'), explicit status flows ('draft → fcp → accepted/rejected'), a copy-paste-able call ('write({ document: { path, template: "<name>" } })'), and conditional agent directives ('more than 14 days, surface it') make the guidance mostly executable. The gap keeping it below anchor 5: template names for proposals, decisions, specs, and postmortems are never enumerated — only the three guide templates are named. | 4 / 5 |
Workflow Clarity | The lifecycle is clearly sequenced with an explicit flow diagram and status gates (accepted, derived, when things break), and the table routes each task type to a sibling skill. It sits at anchor 4 rather than 5 because there are no validation or recovery checkpoints (e.g., what to check before freezing a decision or advancing a status), though no destructive/batch cap applies. | 4 / 5 |
Progressive Disclosure | The body appropriately keeps per-folder rules inline while delegating workflow detail one level deep to sibling skills, clearly signaled via the workflow table — good structure per anchor 4. It misses anchor 5 because template discovery is implicit (names scattered across sections rather than a clear index), and no bundle files exist to verify the referenced paths against. | 4 / 5 |
Total | 17 / 20 Passed |