# Generate Branch Name

> Generate a semantic Git branch name from issue context for ADW workflows. Use before starting work on an issue. Use when this capability is needed.

- Skill: `tomevault-io/generate-branch-name` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/generate-branch-name`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/generate-branch-name/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/generate-branch-name

---


# Branch Name Generation

Generate a semantic Git branch name following the convention.

## Branch Naming Convention

```text
{type}-{issue_number}-{short_id}-{slug}
```

Components:

- **type**: `feat`, `fix`, `chore` (from issue classification)
- **issue_number**: GitHub issue number
- **short_id**: 8-character identifier (ADW ID if provided)
- **slug**: Kebab-case summary of issue (max 30 chars)

## Examples

```text
feat-123-a1b2c3d4-add-user-auth
fix-456-e5f6g7h8-login-double-submit
chore-789-i9j0k1l2-update-dependencies
```

## Rules

1. Use lowercase letters, numbers, and hyphens only
2. No spaces or special characters in slug
3. Slug should be descriptive but concise (max 30 chars)
4. Response should be ONLY the branch name, nothing else

## Arguments

- **$1**: Issue type (`feat`, `fix`, `chore`)
- **$2**: Short ID (8 characters, or generate one)
- **$ARGUMENTS**: Issue title or description

## Generation Process

1. Take the issue type from $1
2. Extract issue number if present in arguments
3. Use provided short ID from $2 or generate 8 random hex chars
4. Create slug from issue description:
   - Convert to lowercase
   - Replace spaces with hyphens
   - Remove special characters
   - Truncate to 30 characters
   - Remove trailing hyphens

## Issue Context

Type: $1
ID: $2
Issue: $ARGUMENTS

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/melodic-software) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->