# New Branch

> Create a GitHub branch from main with the project naming convention

- Skill: `evermind-ai/new-branch` (Agent Skill)
- Install (CLI): `npx skillmds@latest add evermind-ai/new-branch`
- Raw SKILL.md: https://api.skillmd.com/api/skills/evermind-ai/new-branch/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: EverMind-AI (https://skillmd.com/u/evermind-ai)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/evermind-ai/new-branch

---


# /new-branch

Cut a new branch for the GitHub repository.

## Branch model

```
main       = default and protected branch
feat/*     = feature work
fix/*      = bug fixes
docs/*     = documentation-only changes
ci/*       = CI, build, and developer-experience changes
chore/*    = repository maintenance
refactor/* = behavior-preserving code structure changes
```

## Steps

1. Ask (or infer) the change type: `feat`, `fix`, `docs`, `ci`, `chore`, or
   `refactor`.
2. Update `main` first:
   ```bash
   git checkout main
   git pull --ff-only
   ```
3. Create the branch with a kebab-case slug:
   ```bash
   git checkout -b <type>/<short-slug>
   ```
4. Keep the branch scoped to one purpose and open a pull request back to
   `main`.

## Naming

- `feat/add-agentic-rerank`, `fix/empty-profile-crash`,
  `docs/quickstart-config`, `ci/check-github-docs`.
- Lowercase, hyphen-separated, no spaces, concise.

Never commit directly to `main` — always use a branch and pull request.