Content
70%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 strongly actionable, well-sequenced autonomous-development workflow with real validation and error-recovery loops. Its weaknesses are redundancy (the progress-file format appears twice) and progressive disclosure: the skill is a 280-line monolith whose only external references (autopilot.sh, templates README) are missing from the bundle.
Suggestions
Remove the duplicate progress-file template — keep the full worked example in 'Progress File Format' and have Step 2 reference it instead of restating a skeleton.
Ship the referenced bundle files (scripts/autopilot.sh and templates/autopilot/README.md) or remove/inline those sections so Script Mode is not dead-ended by dangling references.
Move the Anti-Rationalization table and the Output template into a references/ file (e.g., PATTERNS.md) to cut inline tokens while keeping the main loop lean.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly procedural with no explanations of concepts Claude already knows, but the progress-file format is fully duplicated (the Step 2 template plus the ~40-line 'Progress File Format' section), and checkpoint/retry guidance repeats in Step 3, the Rules, and the Anti-Rationalization table. This matches 'mostly efficient but could be tightened' rather than anchor 4's 'minor instances'. | 3 / 5 |
Actionability | Concrete, executable guidance dominates: bash commands for progress checks and git tagging, a complete progress.md template, and a full Agent-call template with retry policy. The gap keeping it from anchor 5 is that Script Mode ('Maximum Performance') hinges on ./scripts/autopilot.sh, which does not exist in the bundle, and the Agent call is a placeholder template rather than copy-paste ready. | 4 / 5 |
Workflow Clarity | The four-step workflow is clearly sequenced (PRD resolution with a BLOCKED gate, task extraction, iteration loop 3a-3f, completion) with explicit validation (git log check, tests, tsc --noEmit), feedback loops (max 2 retries then BLOCKED), checkpoints per task, and an eight-rule checklist. This matches the anchor-5 pattern of explicit validation, error-recovery loops, and checklists for a complex batch process. | 5 / 5 |
Progressive Disclosure | Sections are well-organized, but the bundle contains no scripts/, references/, or assets/ directories while the body references ./scripts/autopilot.sh and templates/autopilot/README.md — dangling pointers that cannot be followed. Content that belongs in separate files (the full progress-format spec, Script Mode docs) is inlined, matching 'some structure but could be better organized' rather than anchor 4. | 3 / 5 |
Total | 15 / 20 Passed |