Content
76%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 and concise with executable commands throughout, but its workflow clarity is capped because destructive operations lack validation checkpoints before cleanup. Adding a verify-merged step before branch/worktree deletion would lift it.
Suggestions
Insert a validation checkpoint before destructive cleanup, e.g. verify the PR is merged ('gh pr view --json state --jq .state') before running 'git push origin --delete' and worktree removal.
Consider moving the Multi-Repo Downstream Scenarios detail into a separate reference file to keep SKILL.md a leaner overview.
Add a brief feedback loop for worktree cleanup when 'git worktree remove' fails (e.g. fall back to prune) to make error recovery explicit.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient and assumes Claude's knowledge of git/gh, with copy-paste commands and minimal padding; a few framing sentences ('No filesystem collisions, no branch-switching overhead') could be trimmed. | 4 / 5 |
Actionability | Provides fully executable, copy-paste-ready bash commands for branching, PR creation, worktree setup, and cleanup, with concrete naming conventions covering the common cases. | 5 / 5 |
Workflow Clarity | Steps are clearly sequenced, but destructive and batch operations (branch deletion, 'git push origin --delete', worktree removal) lack explicit validation that the PR merged successfully before cleanup, which per the guidelines caps workflow clarity at 3. | 3 / 5 |
Progressive Disclosure | A single well-organized SKILL.md with clear section headers and no nested references; good structure, though at ~200 lines some multi-repo detail could arguably live in a reference file. | 4 / 5 |
Total | 16 / 20 Passed |