CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

branchout

Use when working in a manyrepo workspace managed by Branchout (~/projects/*/), finding repos the user mentions by name (even if not exactly) within the naming-convention-based folder structure, cloning updating or adding repos, running isolated builds via wrappers like branchout mvn or branchout yarn, or when someone mentions Branchout or asks what Branchout is. Detect by Branchoutfile or .branchout in current or parent directories.

78

2.63x
Quality

91%

Does it follow best practices?

Impact

100%

2.63x

1 of 3 eval scenarios. Add 2 more for a full score.

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

78%Weight 40%Scale 1-5

Reviews 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.

DimensionReasoningScore

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

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

An exemplary description: it states concrete capabilities (find/clone/update/add repos, run isolated builds via wrappers), gives explicit 'Use when' triggers including the tool name, and adds a file-marker detection heuristic. Third-person/imperative voice matches the good examples with no padding.

DimensionReasoningScore

Specificity

Multiple concrete actions are named: "finding repos the user mentions by name (even if not exactly)", "cloning updating or adding repos", "running isolated builds via wrappers like branchout mvn or branchout yarn", plus a concrete detection mechanism ("Detect by Branchoutfile or .branchout"). This matches the anchor for multiple specific concrete actions with comprehensive coverage; anchor 4 would require noticeable gaps, which are absent.

5 / 5

Completeness

Both questions are answered explicitly: what — "finding repos... cloning updating or adding repos, running isolated builds via wrappers"; when — "Use when working in a manyrepo workspace managed by Branchout... or when someone mentions Branchout or asks what Branchout is. Detect by Branchoutfile or .branchout". This matches the anchor exemplar for clear and explicit what AND when with concrete trigger phrases, so a 4 ('when' less explicit) is ruled out.

5 / 5

Trigger Term Quality

Natural trigger terms are comprehensively covered: the tool name itself ("when someone mentions Branchout or asks what Branchout is"), workspace context ("manyrepo workspace", "~/projects/*/"), user verbs ("cloning updating or adding repos"), wrapper commands ("branchout mvn or branchout yarn"), and marker files ("Branchoutfile or .branchout"). No common phrasing for this domain is missing; anchor 4 would require natural terms a user would say to be absent.

5 / 5

Distinctiveness Conflict Risk

Branchout is a clear niche tool, and the description anchors triggering to its own markers ("managed by Branchout", "branchout mvn", "Branchoutfile or .branchout"), minimizing overlap with generic git or build skills. Conflict risk is minimal, fitting the 'clear niche with distinct triggers' anchor rather than the 'minor overlap risk' anchor at 4.

5 / 5

Total

20

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

Branchout/branchout-skills

Path

skills/branchout/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.