CtrlK
BlogDocsLog inGet started
Tessl Logo

new-branch

Create a GitHub branch from main with the project naming convention

58

Quality

66%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/new-branch/SKILL.md
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.

The content is a lean, well-structured, actionable guide that supplies project-specific branch conventions and executable git commands without padding Claude's existing knowledge. Its main gap is the absence of explicit verification checkpoints in the workflow and a small redundancy in the intro line.

DimensionReasoningScore

Conciseness

The body is efficient and assumes Claude's git competence — the branch model table and naming examples are project-specific knowledge Claude lacks, and code blocks are minimal. Only minor trimmable redundancy (the intro line 'Cut a new branch for the GitHub repository' restates the description). Not a 5 because of that small redundancy; not a 3 because there is no over-explanation of concepts Claude already knows.

4 / 5

Actionability

Provides concrete, executable commands ('git checkout main', 'git pull --ff-only', 'git checkout -b <type>/<short-slug>') with concrete naming examples. Not a 5 because the slug is a placeholder and step 1 defers type selection to 'Ask (or infer)', leaving a small gap before copy-paste readiness; not a 3 because the given commands are real and runnable, not pseudocode.

4 / 5

Workflow Clarity

A clear four-step sequence (determine type → update main → create branch → keep scoped and open PR) with concrete commands per step. Not a 5 because there are no explicit validation/checkpoint steps (e.g., confirm main is current or branch was created); not a 3 because the sequence is well-defined and branch creation is non-destructive, so the missing-validation cap does not apply.

4 / 5

Progressive Disclosure

The skill is under 50 lines with no need for external references (no references/scripts/assets bundle exists), and content is organized into clear sections (Branch model, Steps, Naming) — meeting the simple-skill exception for a top score. Not lower because structure is clean and navigation within the single file is unambiguous.

5 / 5

Total

17

/

20

Passed

Description

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

The description is concise, third-person, and names a concrete domain-specific action, but it omits any explicit 'Use when...' trigger guidance and offers only a single action, leaving completeness and trigger coverage limited.

Suggestions

Add an explicit trigger clause, e.g. 'Use when starting new work that needs a branch off main or when the user asks to create/cut a new branch.'

Broaden trigger terms to include natural variations users say ('new branch', 'feature branch', 'cut a branch') alongside 'GitHub branch'.

Optionally enumerate the supported branch types (feat, fix, docs, ci, chore, refactor) in the description to raise specificity and distinctiveness.

DimensionReasoningScore

Specificity

Names the domain ('GitHub branch from main') and one concrete action (create a branch with the naming convention), but coverage is not comprehensive — it is a single action rather than a list of capabilities. Not a 2 because the action is concrete and domain-specific rather than generic; not a 4 because there are not several specific actions listed.

3 / 5

Completeness

Has a clear 'what' ('Create a GitHub branch from main with the project naming convention') but no 'Use when...' clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. Not a 4 because 'when' is entirely absent rather than weakly present.

3 / 5

Trigger Term Quality

Includes relevant natural terms ('GitHub branch', 'main', 'naming convention') that a user might say, but misses common variations/synonyms like 'new branch', 'feature branch', or 'cut a branch'. Not a 4 because keyword coverage is limited to a narrow phrasing rather than broad natural-term coverage.

3 / 5

Distinctiveness Conflict Risk

The project-specific naming convention angle gives it a clear niche distinct from generic git skills, with only minor overlap risk against general branch/git workflows. Not a 5 because 'create a branch' could still overlap with broader git helper skills absent an explicit trigger phrase.

4 / 5

Total

13

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
EverMind-AI/EverOS
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.