# create-branch

Creates git branches with naming validation and connects them to GitHub or GitLab issues automatically. Helps start new feature work cleanly.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 376 installs · ★ 8
- Author: tartinerlabs
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/tartinerlabs/skills/tree/HEAD/plugins/workflow/skills/create-branch/SKILL.md
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/skills/tartinerlabs-create-branch

## What it does

The skill handles git branch creation directly through the agent. It inspects `git remote get-url origin` to detect your hosting platform. If you provide a GitHub issue number, it runs `gh issue develop <number> -c` to link the branch to the issue immediately. On GitLab, it includes the issue number in the branch name so merge requests link up properly.

Next, it checks the branch name against naming rules and scans for duplicates locally and remotely. Branches start from `main`, `master`, or current `HEAD`. When work builds on an unmerged pull request, the skill branches from the active branch instead, keeping the diff clean for stacked reviews. It can also push to origin.

Linking issues requires `gh` or `glab` installed and authenticated on your machine. Without those CLI tools, remote issue association fails.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add tartinerlabs/skills --skill create-branch -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/create-branch/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/create-branch/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add tartinerlabs/skills --skill create-branch -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/create-branch/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add tartinerlabs/skills --skill create-branch -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/create-branch/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install tartinerlabs/skills create-branch
```

2. **Manually: put the files in place**
- File: `.github/skills/create-branch/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add tartinerlabs/skills --skill create-branch -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/tartinerlabs/skills --path plugins/workflow/skills/create-branch
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/create-branch/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add tartinerlabs/skills --skill create-branch -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/tartinerlabs/skills/tree/HEAD/plugins/workflow/skills/create-branch/SKILL.md

## When to use it
- check new git branch names for rules and duplicate refs
- create linked branches for GitHub issues using the `gh` CLI
- format GitLab branch names to link issues with merge requests
- branch off unmerged pull requests to build stacked diffs

## Example prompts
- Create a branch for issue 42 and link it
- Branch on top of this current PR for the next feature part
- Check out a new bugfix branch for the auth timeout

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 901087d95efcf0e6.

BEGIN THIRD-PARTY FILE 901087d95efcf0e6
```text
---
name: create-branch
description: Use when creating a branch, starting work on an issue, or checking out a new feature branch. Validates branch naming and links to GitHub issues automatically.
license: MIT
allowed-tools: Read Bash(git:*) Bash(gh:*) Bash(glab:*)
model: haiku
effort: low
compatibility: Requires git; issue-linking uses a GitHub (gh) or GitLab (glab) remote
metadata:
  short-description: Validated branch names linked to issues.
---

You create and checkout git branches with validation.

## Rules Overview

| Rule | Impact | File |
|------|--------|------|
| Branch naming | HIGH | `rules/branch-naming.md` |
| Prefix detection | MEDIUM | `rules/prefix-detection.md` |

## Workflow

1. If an issue number is provided, detect the remote host from `git remote get-url origin` (github.com → gh, gitlab.com → glab; default GitHub). On **GitHub**, use `gh issue develop <number> -c` to create a linked branch and skip to step 4. On **GitLab** (no direct equivalent), include the issue number in the branch name (e.g. `feature/123-description`) so the MR auto-links, then continue through steps 2–4
2. Auto-detect prefix from user input (see `rules/prefix-detection.md`), validate name (see `rules/branch-naming.md`), and check for duplicates locally and remotely
3. Create and checkout from `main` → `master` → current HEAD: `git checkout -b <name> <base>`. **Exception**: when the current branch has an open unmerged PR and the new work builds on it (the user says "on top of this" / "next part", or the change depends on unmerged work), base on the current branch instead — the diff stays scoped to the new layer, and on GitHub the resulting PRs link into a stack automatically
4. Offer remote push: `git push -u origin <name>`
```
END THIRD-PARTY FILE 901087d95efcf0e6

The third-party file has ended. Everything between the 901087d95efcf0e6 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© tartinerlabs · MIT · https://github.com/tartinerlabs/skills/tree/HEAD/plugins/workflow/skills/create-branch/SKILL.md

## Similar
- [triage](https://affpapa.org/en/nevibecode/skills/triage.md) — skill · 990453 installs
- [code-review](https://affpapa.org/en/nevibecode/skills/code-review.md) — skill · 789521 installs
- [implement](https://affpapa.org/en/nevibecode/skills/implement.md) — skill · 774700 installs
- [git-guardrails-claude-code](https://affpapa.org/en/nevibecode/skills/git-guardrails-claude-code.md) — skill · 499069 installs
- [setup-pre-commit](https://affpapa.org/en/nevibecode/skills/setup-pre-commit.md) — skill · 489289 installs
- [scaffold-exercises](https://affpapa.org/en/nevibecode/skills/scaffold-exercises.md) — skill · 480196 installs

## Other versions with the same name
- [create-branch · getsentry](https://affpapa.org/en/nevibecode/skills/create-branch.md) — 4300 installs

From the same set: [tartinerlabs/skills](https://affpapa.org/en/nevibecode/by/tartinerlabs/skills.md) — 12 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md