CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

new-branch

The canonical recipe for starting a fresh working branch off a freshly fetched `origin/main` in Meshtastic-Android. Use this whenever a unit of work starts - "new branch off main", "peel off a fresh branch", "dust off

Quality

89%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

96%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.

An exemplary instruction-only skill body: executable commands, explicit preconditions and validation checkpoints, safety rationale for the destructive force-push, and tight, unpadded prose. The only notable weakness is the duplicated branch-prefix table, which reproduces an in-repo canonical list.

DimensionReasoningScore

Conciseness

The body is lean and operational throughout — commands, a compact prefix table, preconditions, and a checklist — with no explanations of concepts Claude already knows. Even the force-push paragraph earns its place by explaining a non-obvious failure mode ("the lease is intact and the wrong branch gets rewritten"), matching anchor 5.

5 / 5

Actionability

Fully executable, copy-paste-ready commands in both recipes (`git fetch upstream --prune --tags`, `git switch -c <branch-name> upstream/main`, `gh pr checkout <NNNN>`, `git push --force-with-lease`) plus concrete verification commands and real example slugs like `fix/r8-animation-release` — anchor 5.

5 / 5

Workflow Clarity

Preconditions with verification commands (`git status --porcelain`, `git remote -v`), a numbered recipe with a sanity check, a rebase variant with explicit pre-push validation ("confirm this is the PR you meant, before any push"), conflict-resolution feedback, and a post-branch checklist. The destructive force-push is well guarded, so the cap does not apply — anchor 5.

5 / 5

Progressive Disclosure

Well-organized single-topic sections with one-level-deep, clearly signaled references (`.specify/memory/constitution.md`, `AGENTS.md`, `CLAUDE.md`), no bundle files needed. Minor gap: the 9-row prefix table duplicates the in-repo canonical list that constitution.md and CONTRIBUTING.md already carry, adding a fourth copy with drift risk — anchor 4 rather than 5.

4 / 5

Total

19

/

20

Passed

Description

78%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.

A strong description that clearly states what the skill does and when to use it, with natural quoted trigger phrases and tight scoping to Meshtastic-Android. It is slightly under-specified on concrete actions and misses the 'rebase' trigger term that the body explicitly supports.

Suggestions

Enumerate the concrete actions more fully (e.g., 'fetch upstream, create the branch off origin/main, and rebase stale PRs onto it') to raise specificity beyond a single composite action.

Add 'rebase #NNNN' / 'dust off PR NNNN' as an explicit trigger phrase, since the skill's Rebase Variant covers that workflow but the description never mentions rebasing.

DimensionReasoningScore

Specificity

Names the domain (branching off fetched origin/main in Meshtastic-Android) and one composite action plus its outcome ("so the branch is based correctly and nothing is carried over"), but does not list several discrete actions — the fetch, rebase, and naming coverage in the body is absent. Matches anchor 3 (1-2 concrete actions, not comprehensive) rather than 4.

3 / 5

Completeness

Explicitly answers what ("The canonical recipe for starting a fresh working branch off a freshly fetched `origin/main` in Meshtastic-Android") and when ("Use this whenever a unit of work starts" followed by concrete quoted trigger phrases). Both are explicit with concrete triggers, matching anchor 5 rather than 4 where the 'when' would be less specific.

5 / 5

Trigger Term Quality

Quoted natural phrases "new branch off main", "peel off a fresh branch", "dust off #NNNN" plus "a unit of work starts" give good trigger coverage, but "rebase #NNNN" (a flow the skill explicitly covers) and plain "create a branch" variants are missing — a few natural terms short of anchor 5.

4 / 5

Distinctiveness Conflict Risk

Scoped to Meshtastic-Android branch bootstrap with distinctive triggers like "dust off #NNNN", giving a clear niche, but branch creation is a broadly applicable git operation with minor overlap risk against a generic branch/rebase skill — anchor 4 rather than 5.

4 / 5

Total

16

/

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

meshtastic/Meshtastic-Android

Path

.skills/new-branch/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.