Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-sequenced, actionable worktree setup skill with strong validation checkpoints. Its main weakness is repetition across the Common Mistakes, Red Flags, and Quick Reference sections, and the lack of any external reference structure for a relatively long single-file skill.
Suggestions
Consolidate 'Common Mistakes', 'Red Flags', and the 'Quick Reference' table — they restate the same selection/verification rules; keep one authoritative table and drop the duplicates to improve conciseness.
The creation step's `case $LOCATION in` references $LOCATION and $BRANCH_NAME without defining them; either show how they are derived or replace with a concrete example to keep the code fully copy-paste ready.
For a ~210-line skill, consider moving the per-language setup snippets or the example workflow into a references/ file so SKILL.md stays a lean overview with one-level-deep pointers.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with concrete commands, but the 'Common Mistakes', 'Red Flags' (Never/Always), and 'Quick Reference' table largely restate the inline 'Why critical' notes and selection rules, adding repetition that could be trimmed. | 2 / 3 |
Actionability | Provides concrete, executable commands throughout — git check-ignore, git rev-parse, git worktree add, and per-language setup (npm/cargo/pip/go) — copy-paste ready and specific. | 3 / 3 |
Workflow Clarity | Clear sequenced flow (directory selection → safety verification → creation steps 1–5) with explicit validation checkpoints (check-ignore, baseline tests) and feedback loops ('If tests fail: Report failures, ask whether to proceed'). | 3 / 3 |
Progressive Disclosure | No bundle files exist and everything is inline in a single ~210-line file; sections are well-organized, but repeated reference/flag content that could be split out stays inline, so it is not optimally structured. | 2 / 3 |
Total | 10 / 12 Passed |