A command-line tool that transforms plain English descriptions into consistent, convention-compliant git branch names using AI.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install branch-name-gen
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install branch-name-gen using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is branch-namer?
Branch Namer is a productivity-focused utility designed to streamline version control by generating professional git branch names from simple descriptions. As a core component within the Openclaw Skills library, it eliminates the common friction of manual naming and helps maintain repository hygiene. It interprets user intent to suggest names that adhere to industry best practices, ensuring your repository stays clean and readable without the mental overhead of manual naming.
By leveraging AI to interpret developer intent, it generates short, descriptive, kebab-case names that keep workflows organized. Whether you are working solo or in a large team, this tool provides a standardized approach to version control management, making it an essential addition to any developer's Openclaw Skills toolkit.
branch-namer Use Cases
- Starting a new feature and needing a standardized name immediately.
- Ensuring naming consistency across a distributed engineering team to avoid messy repositories.
- Rapidly creating branches with ticket numbers and custom prefixes for project tracking.
- Standardizing branch names for CI/CD pipelines and automated deployment scripts.
How branch-namer Works
- The developer provides a plain English description of the task via the command line.
- The AI analyzes the description to determine the appropriate work category (e.g., feature, fix, or chore).
- The tool generates a concise, kebab-case branch name following conventional naming patterns.
- Optionally, the tool can execute the git checkout command to create and switch to the new branch automatically.
branch-namer Setup
No permanent installation is required as the tool runs via npx. You must have Node.js 18 or higher and an active OpenAI API key configured in your environment.
# Set your API key
export OPENAI_API_KEY=sk-...
# Run the tool
npx ai-branch "add user authentication with OAuth"
branch-namer Data Schema & Taxonomy
Branch Namer interacts with your local Git environment and follows a specific output structure for the generated branch names to ensure compatibility with most Openclaw Skills workflows.
| Component | Format | Purpose |
|---|---|---|
| Prefix | [type]/ | Categorizes the work (feature/, bugfix/, hotfix/, chore/) |
| Slug | kebab-case | A short, URL-friendly description of the task |
| Ticket (Optional) | String | Prepends a tracking ID like PROJ-123 to the branch name |
Example Output: feature/PROJ-123-add-oauth-support
branch-namer Advanced Features
- Automated branch creation using the --create flag to bypass manual terminal commands.
- Custom prefix support via the --prefix flag to align with specific organizational standards.
- Integrated ticket tracking using the --ticket flag for seamless Jira or GitHub issue linking.
- Intelligent context extraction to automatically differentiate between features and bug fixes.
- Lightweight and dependency-free execution as part of the Openclaw Skills developer toolkit.
SKILL.md
Loading
Related Openclaw Skills
Backup Script Generator
A powerful utility to generate comprehensive, production-ready database backup scripts for any cloud or local destination using AI.
Backup Script Generator
An AI-powered utility that generates comprehensive, production-ready database backup scripts for any cloud or local destination.
auth-auditor
A security audit tool that scans your codebase for authentication vulnerabilities like weak hashing and insecure session management.
Audit Fixer
An AI-driven CLI tool that transforms messy npm audit logs into a prioritized list of actionable security fixes.
Branch Namer
Converts plain English descriptions into clean, kebab-case Git branch names following industry conventions.
Bundle Checker
An AI-powered tool that analyzes bundle size and provides actionable suggestions to reduce bloat in your JavaScript applications.
Featured*
