Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-crafted orchestration skill with excellent workflow clarity and actionability — it provides precise commands, clear decision trees, and robust error handling for a complex parallel execution scenario. Its main weakness is length: at ~300 lines with detailed inline algorithms for edge cases (slug collisions, stale worktree recovery, findings aggregation), it could benefit from extracting some procedural detail into reference files to improve conciseness and progressive disclosure.
Suggestions
Extract the detailed collision-handling algorithm (Step 4a) and retry procedure (Step 6) into reference files (e.g., references/collision-handling.md, references/retry-deferred.md) to reduce the main skill's token footprint.
Consider moving the Step 6.5 aggregation logic (findings table format, issue creation commands, choice handling) into a separate reference file, keeping only the high-level flow in the main skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is quite long (~300 lines) with extensive detail on edge cases like slug collisions, stale worktree metadata, and retry logic. While most content is necessary for a complex orchestration skill, some sections are verbose — the worked example in Step 6, the detailed collision-handling algorithm in Step 4a, and the full aggregation table format could be tightened. However, it avoids explaining concepts Claude already knows and stays focused on domain-specific logic. | 2 / 3 |
Actionability | The skill provides concrete, executable bash commands (git worktree add, git rev-parse, git status --porcelain), specific parameter configurations for Agent tool calls (isolation, run_in_background), exact prompt templates with named placeholders, and precise status values. The guidance is copy-paste ready with clear variable substitution patterns. | 3 / 3 |
Workflow Clarity | The workflow is exceptionally well-sequenced with numbered steps (0-7), explicit validation checkpoints (pre-flight validation, worktree verification, git pull), clear error recovery paths (deferred set, retry logic with prune), user confirmation gates via AskUserQuestion at multiple decision points, and a feedback loop for failed features. The ready/deferred split with sequential retry is a well-designed error recovery pattern. | 3 / 3 |
Progressive Disclosure | The skill references external files appropriately (preflight-validation.md, worker-instructions.md, step-0-fast-path.md) for delegated logic, which is good progressive disclosure. However, the main SKILL.md itself is very long with substantial inline detail — the collision-handling algorithm in Step 4a, the full retry procedure in Step 6, and the aggregation logic in Step 6.5 could potentially be extracted to reference files. No bundle files were provided to verify the referenced paths exist. | 2 / 3 |
Total | 10 / 12 Passed |