Content
78%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 strong, actionable body: copy-paste commands for the common workflows, Branchout-specific gotchas Claude would not know, and sensible safety checkpoints (stash-before-checkout, trust-before-clone). The main defects are redundancy (trust and .gitignore notes repeated) and a CLI Reference section that points to a REFERENCE.md file not present in the bundle.
Suggestions
Bundle REFERENCE.md alongside SKILL.md (or inline the key commands) — the 'CLI Reference' section defers to a file that does not exist in the skill directory, leaving the full command documentation unreachable.
State the trust warning and the root-.gitignore / cd-before-git caveats once each (e.g., in Gotchas) instead of repeating them across Quick Start, workflows, code comments, and the directory layout.
Add a verification step after the batch `branchout pull` workflow (e.g., run `branchout status` to confirm all repos cloned cleanly) to close the feedback loop on the parallel batch operation.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and efficient — tables for commands and config files, no explanations of concepts Claude already knows, Branchout-specific details only. Minor trimming opportunities keep it below a 5: the trust warning is repeated in Quick Start, the 'Start using a new workspace' prose, and a code comment; the root-.gitignore caveat appears in the layout comment, the 'Work in a specific repo' section, and Gotchas; and "This preserves the user's work and makes stashes easy to identify later" explains git stash behavior Claude already knows. It is more efficient than the anchor-3 example, which is why it is not scored 3. | 4 / 5 |
Actionability | Commands are copy-paste ready and cover the common cases: the brew install block, `branchout init https://github.com/<org>/<projection-repo>.git` + `branchout pull`, `branchout clone my-new-repo`, `cd group/group-repo-name` + `git status`, and the stash workflow with a concrete `git stash save "user-work-$(date '+%Y%m%d-%H%M%S')"`. Only trivial asides are non-executable ("Use `sed` to remove invalid lines if needed" lacks the invocation), which does not rise to the 'minor gaps' of anchor 4. | 5 / 5 |
Workflow Clarity | Each workflow (start a workspace, add a repo, work in a repo, switch branches) has a clear, ordered command sequence, and safety checkpoints are present for the risky steps: "stash any uncommitted work with a descriptive name including the date and time" before checkout, "Ensure the repos being cloned or pulled are trusted before running those commands" before the batch pull, and "Override with BRANCHOUT_THREADS if firewall software is causing this to fail" as failure remediation. It is not a 5 because there is no post-operation verification (e.g., confirming clones succeeded via `branchout status`) closing the loop on the batch pull, and not a 3 because validation for the batch/destructive steps is present, not absent. | 4 / 5 |
Progressive Disclosure | The body itself is well organized (Quick Start, Installation, Layout, Configuration, Workflows, Gotchas) and defers bulk CLI detail via "See REFERENCE.md for a full reference of commands and output" — a clearly signaled one-level reference. However, no bundle files exist: there is no `references/`, `scripts/`, or `assets/` directory and REFERENCE.md is absent from the skill directory entirely, so the promised full command reference is unreachable and the disclosure structure is broken in practice. This lands between anchor 4 (references present and working with minor gaps) and the structural failure of a missing pathway, so it cannot score above 3. | 3 / 5 |
Total | 16 / 20 Passed |