Content
81%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.
Highly actionable content with an exemplary safety-sequenced workflow for a destructive batch operation — explicit confirmation gates, fallbacks, and recovery loops throughout. The main costs are token redundancy between the Rules and Steps sections and a lengthy inline interpretation section that pushes the file past overview length.
Suggestions
Deduplicate the Rules section against Steps 2, 4, and 5 (fetch origin/x, cleanup-candidate surfacing, confirmation before deletion are each stated twice) — keep Rules for invariants only and let the steps carry the procedure.
Move "How To Interpret The Result" into a reference file (e.g. references/result-codes.md) and keep only the summary table inline, trimming SKILL.md toward overview length.
Tighten long multi-clause sentences such as the MERGED_TO_ORIGIN_X_BY_PATCH_ID paragraph into short per-code bullet points.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly operational with no explanation of concepts Claude already knows, but the "Rules" section substantially duplicates instructions restated in Steps 2, 4, and 5 (fetch origin/x, cleanup candidates, confirmation before deletion), and "How To Interpret The Result" contains dense multi-clause sentences that could be tightened. Not 4 because the duplication is more than minor trimming; not 2 because there is no generic padding or tutoring. | 3 / 5 |
Actionability | Every step gives copy-paste-ready commands with all selection variants ("check 1", "check 1,3", "check A"), exact removal commands ("rtk git worktree remove <path>", "rtk proxy rm -rf <path>"), and the exact user-facing reply phrases to append. The referenced script exists with matching list/check/cleanup-candidates subcommands. Matches the fully-executable anchor. | 5 / 5 |
Workflow Clarity | A clear 5-step sequence with explicit validation checkpoints and feedback loops appropriate to a destructive batch operation: always fetch before checking, dirty state reported separately, explicit user confirmation gate before any deletion ("Never auto-delete anything before the user explicitly confirms"), NEEDS_MANUAL_REVIEW fallback instead of guessing, and sandbox-blocked → request approval → rerun recovery. The destructive-operation cap does not apply because verification is thorough. | 5 / 5 |
Progressive Disclosure | Good structure: the SKILL.md workflow points to a single real one-level-deep bundle script (scripts/1k-worktree-clean.sh, verified to exist with the referenced subcommands), and sections are clearly headed. Not 5 because the skill is ~130 lines with the entire result-code interpretation ("How To Interpret The Result") and output contract inlined — material that could live in a reference file at this length; not 3 because references are real, clearly signaled, and nothing is buried. | 4 / 5 |
Total | 17 / 20 Passed |