Content
63%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.
The content is highly actionable with concrete tool calls, executable fallback code, and explicit validation checkpoints for destructive state changes, but it suffers from redundant restating of the dependency cascade and is a monolithic file that under-uses progressive disclosure.
Suggestions
Consolidate the repeated autopilot→ralph→ultrawork dependency cascade into one authoritative section and reference it elsewhere instead of restating.
Move the long bash fallback, the legacy compatibility file list, and the team two-pass protocol into reference files (e.g., references/fallback.sh, references/legacy-state.md) and link to them from SKILL.md.
Reconcile the mode list between "Auto-Detection" (12 modes) and the "Implementation Steps" handlers so the workflow covers every enumerated mode consistently.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is substantive and free of basic-concept padding, but the autopilot→ralph→ultrawork dependency cascade and cleanup logic are restated across "What It Does", "Auto-Detection", "Implementation Steps", and "Implementation Notes", so it could be noticeably tightened. | 3 / 5 |
Actionability | Concrete, executable guidance dominates — exact ToolSearch query, state_clear/state_read calls with arguments, and a copy-paste bash fallback — but the team two-pass protocol is pseudocode-style and the fallback's MODE placeholder must be hand-edited. | 4 / 5 |
Workflow Clarity | Destructive state mutation is guarded by explicit validation ("If this write fails, stop immediately", "require success", report failures) and feedback loops, but inconsistent mode lists (12 modes in Auto-Detection vs. fewer handled in Implementation Steps) create minor gaps. | 4 / 5 |
Progressive Disclosure | Section headers give reasonable structure, but this ~390-line skill is monolithic with no detail-file references; the bash fallback, legacy compatibility list, and team protocol are inlined content that could live in separate files. | 3 / 5 |
Total | 14 / 20 Passed |