Converts plain English descriptions into clean, kebab-case Git branch names following industry conventions.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install branch-namer
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-namer 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 specialized utility designed to solve the common developer frustration of deciding on branch naming conventions. As a part of the Openclaw Skills ecosystem, it leverages natural language processing to interpret the context of your task and generate standardized branch names using prefixes like feature/, bugfix/, or hotfix/. This tool ensures that repository structures remain clean, consistent, and easy to navigate for all team members.
By integrating this skill into your local development environment, you remove the mental overhead of manual naming while ensuring compliance with team-wide standards. It is particularly useful for developers who want to move quickly from a task description to a functional Git branch without worrying about formatting or naming collisions.
Branch Namer Use Cases
- Standardizing Git branch naming across large engineering teams to maintain repository health.
- Converting project management ticket titles into valid, descriptive kebab-case branch names.
- Streamlining the creation of feature and hotfix branches directly from the command line.
- Automating local branch setup during the onboarding of new developers to Openclaw Skills projects.
How Branch Namer Works
- The developer provides a descriptive string explaining the work to be done via the CLI.
- The tool analyzes the text to determine the intent, such as a new feature, a bug fix, or a maintenance chore.
- It transforms the description into a concise, kebab-case string, removing stop words and unnecessary punctuation.
- If specified, the tool appends ticket numbers or custom prefixes to the generated name.
- Optionally, the tool executes a git checkout command to create and switch to the new branch immediately.
Branch Namer Setup
To use this tool within the Openclaw Skills framework, ensure you have Node.js 18+ and an OpenAI API key configured.
export OPENAI_API_KEY="your_api_key_here"
npx ai-branch "add user authentication with OAuth"
You can also use the --create flag to automate the Git workflow:
npx ai-branch "fix mobile navigation bug" --create
Branch Namer Data Schema & Taxonomy
Branch Namer processes natural language input and outputs formatted strings. It interacts with the local .git configuration when the creation flag is used.
| Input Parameter | Type | Description |
|---|---|---|
| Description | String | The plain English task description |
| --prefix | String | Manually set the branch type (e.g., chore, refactor) |
| --ticket | String | A ticket ID to include in the branch name |
| --create | Boolean | Whether to run the git checkout command automatically |
Branch Namer Advanced Features
- Context-aware intent detection to automatically assign the correct prefix based on your description.
- Support for custom prefixes to align with specific organizational policies within the Openclaw Skills ecosystem.
- Integrated ticket tracking support to link branches directly to project management tasks.
- Direct Git integration for zero-friction branch switching and creation.
SKILL.md
Loading
Related Openclaw Skills
branch-namer
A command-line tool that transforms plain English descriptions into consistent, convention-compliant git branch names using AI.
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.
Bundle Checker
An AI-powered tool that analyzes bundle size and provides actionable suggestions to reduce bloat in your JavaScript applications.
Bundle Checker
An AI-powered diagnostic tool that analyzes build outputs to identify bundle bloat and provide actionable reduction strategies.
Featured*
