Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The content is a well-sequenced, highly actionable workflow with strong validation checkpoints for its destructive operations. Its weaknesses are token-efficiency redundancy across the Quick Reference / Common Mistakes / Red Flags sections and a monolithic single-file structure that underuses progressive disclosure.
Suggestions
Consolidate the overlapping rules in Common Mistakes and Red Flags (e.g. CWD-before-worktree-removal, discard confirmation, Options 1&4-only cleanup) into a single checklist to remove restatement, since the step bodies already enforce most of them.
Move the detailed cleanup-provenance logic and the Common Mistakes / Red Flags reference material into a referenced file (e.g. references/cleanup.md) so SKILL.md stays a lean overview with one-level-deep navigation.
Consider trimming the Quick Reference option matrix, as it restates the merge/push/keep/cleanup behavior already specified per-option in Step 5.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence (no git basics explained), but the Quick Reference, Common Mistakes, and Red Flags sections substantially restate each other and the step content (e.g. 'cd to main repo root before worktree removal' appears in Step 6, Common Mistakes, and Red Flags), so it could be tightened. | 2 / 3 |
Actionability | It provides concrete, largely copy-paste-ready bash (git worktree remove, gh pr create with heredoc, git branch -D), exact menu text to present, and exact confirmation wording; placeholders like <base-branch> are justified by the task context. | 3 / 3 |
Workflow Clarity | A clear 6-step sequence with explicit validation checkpoints (tests pass before options, verify tests on merged result, typed 'discard' confirmation) and feedback loops; the destructive/batch operations are guarded rather than missing validation. | 3 / 3 |
Progressive Disclosure | No bundle files exist and the skill is a single 248-line SKILL.md with reference-type content (Common Mistakes, Red Flags, detailed cleanup provenance) inlined rather than split into one-level-deep referenced files, fitting 'content that should be separate is inline'. | 2 / 3 |
Total | 10 / 12 Passed |