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.
A well-structured operational skill: executable commands throughout, an explicit sequenced workflow with validation and error-recovery paths, and a decision table that makes edge cases unambiguous. Remaining polish is minor — tighten two redundant explanation spots, define the placeholder variables in the worktree-add block, and consider splitting the reference tables into a bundled file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean: it assumes git competence, skips worktree concept explanations, and lets runnable commands carry the instruction. Minor over-explanation remains — "Why critical: Prevents accidentally committing worktree contents to repository" restates the preceding MUST directive, and the rationalizations table is borderline padding — so it is efficient with minor trim opportunities rather than fully lean. | 4 / 5 |
Actionability | Nearly everything is executable: rev-parse detection commands, a submodule guard, check-ignore verification, `git worktree add`, and a concrete setup matrix. The one gap is `path="$LOCATION/$BRANCH_NAME"`, which references undefined variables, so that block is not copy-paste ready — keeping it at 'mostly executable with minor gaps' rather than fully executable. | 4 / 5 |
Workflow Clarity | The sequence is explicit (Step 0 detect → Step 1a/1b create → Step 2 setup → Step 3 baseline) with validation checkpoints (submodule guard, MUST check-ignore, clean-baseline tests) and error-recovery loops (sandbox fallback, report-failures-and-ask on test failure), plus a quick-reference table mapping every situation to an action. This matches the top anchor: clear sequence, explicit validation, feedback loops for error recovery. | 5 / 5 |
Progressive Disclosure | No bundle files exist, and the body is well-organized with clear section headers, a decision table, and a quick-reference index. At ~165 lines everything is inline; the Quick Reference and Common Rationalizations tables are candidates for a separate reference file, leaving it at 'good structure; most content appropriately placed' rather than a textbook clear-overview-with-references layout. | 4 / 5 |
Total | 17 / 20 Passed |