Conventional Branch Names

SkillDev tools

Create git branches named by conventional-commit type: <type>/<kebab-description>. Use when: creating any new git branch, starting work that needs a branch, or naming a branch. Triggers on: 'create branch', 'new branch', 'branch off', 'checkout -b', '/branch'.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Conventional Branch Names skill

What this skill tells your AI

The instructions your AI receives, as published by ahonn/dotfiles in .claude/skills/branch/SKILL.md and read by ahel’s review.

Branch names use the same type vocabulary as conventional commits:

<type>/<short-kebab-description>

Examples: feat/user-auth, fix/login-crash, refactor/api-client, chore/update-deps.

Rules

  1. Type — the conventional-commit type the dominant commit on this branch would have: feat, fix, refactor, perf, docs, test, build, ci, chore, revert.
  2. Description — 2–4 words, kebab-case, specific: what the branch delivers, not how. Lowercase only, no spaces.
  3. Ticket IDs — if the work has a ticket, put its ID after the type: feat/lin-123-user-auth.
  4. No agent-branded prefixes — never codex/..., claude/..., or agent/.... The branch describes the work, not the tool that wrote it.
  5. Base — branch off the up-to-date default branch unless the work explicitly builds on the current branch.

Procedure

  1. Derive type and description from the requested work (or "$ARGUMENTS" if provided).
  2. Validate: git check-ref-format --branch <name>.
  3. Create: git switch -c <name>.

Signals

GitHub stars
62
Forks
2
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
branch
Source
github.com/ahonn/dotfiles