Opencode-config-backup branch-namer

Generate descriptive git branch names from plain English. Use when you need a branch name that follows conventions.

install
source · Clone the upstream repo
git clone https://github.com/jieni777/opencode-config-backup
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/jieni777/opencode-config-backup "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/branch-namer" ~/.claude/skills/jieni777-opencode-config-backup-branch-namer-a6061d && rm -rf "$T"
manifest: skills/branch-namer/SKILL.md
source content

Branch Namer

Naming branches is harder than it should be. Is it feature/user-auth or feat/add-user-authentication? This tool generates consistent, conventional branch names from plain English descriptions.

One command. Zero config. Just works.

Quick Start

npx ai-branch "add user authentication with OAuth"

What It Does

  • Generates branch names following common conventions (feature/, bugfix/, hotfix/)
  • Keeps names short but descriptive
  • Uses kebab-case consistently
  • Can create the branch for you with --create flag
  • Supports custom prefixes and formats

Usage Examples

# Get a branch name suggestion
npx ai-branch "fix the login button not working on mobile"

# Create the branch immediately
npx ai-branch "add dark mode support" --create

# Use a specific prefix
npx ai-branch "update dependencies" --prefix chore

# Include ticket number
npx ai-branch "user profile page crashes on load" --ticket PROJ-123

Best Practices

  • Be specific in your description - "fix bug" gives worse results than "fix crash when user has no profile photo"
  • Include context - Mention the feature area: "checkout flow: add shipping address validation"
  • Use --create sparingly - Review the suggestion first, especially on shared repos
  • Match team conventions - If your team uses different prefixes, use --prefix

When to Use This

  • Starting a new feature and blanking on a good branch name
  • Want consistent naming across your team
  • Working on multiple tasks and need to track what each branch does
  • Onboarding and not sure what naming conventions the team uses

Part of the LXGIC Dev Toolkit

This is one of 110+ free developer tools built by LXGIC Studios. No paywalls, no sign-ups, no API keys on free tiers. Just tools that work.

Find more:

Requirements

No install needed. Just run with npx. Node.js 18+ recommended. Requires OPENAI_API_KEY environment variable.

export OPENAI_API_KEY=sk-...
npx ai-branch --help

How It Works

Takes your description and determines the appropriate branch type (feature, fix, chore, etc.). Extracts key terms and creates a concise, readable branch name following conventional naming patterns. Can optionally run git checkout -b for you.

License

MIT. Free forever. Use it however you want.