К основному содержанию
скилл CX Codex

pr-branch-naming — скилл для Claude Code: что делает и как установить

Скилл pr-branch-naming для Claude Code подбирает имя Git-ветки и заголовок PR по описанию задачи. Запускается, когда нужно создать ветку, открыть PR или придумать для них названия.

MIT ★ 107 обновлён 2026-11-08

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add thedesignproject/agent-skills --skill pr-branch-naming -a claude-code
Открыть на GitHub

Что делает pr-branch-naming

Скилл предлагает имя ветки и заголовок PR в согласованном формате. Он выбирает тип изменения и область продукта, а затем собирает имя ветки вида feature/описание и заголовок PR вида feat(область): описание. Если область неясна, задаёт один уточняющий вопрос.

Когда описание не передано, скилл пытается понять задачу по git status и последним коммитам; если этого недостаточно, спрашивает, для чего нужна ветка. Создать ветку или черновик PR он предлагает отдельно и выполняет только после явного подтверждения. Перед созданием ветки проверяет рабочее дерево, перед PR — авторизацию через gh; для PR также проверяет коммиты относительно базовой ветки.

Для этих действий нужны Git и GitHub CLI gh. Если gh не авторизован, скилл предлагает выполнить gh auth login и останавливается. Команды reset --hard, branch -D и push --force он не запускает.

Какие задачи решает

  • придумать имя ветки по описанию задачи
  • согласовать префикс ветки с типом изменения
  • сформулировать заголовок PR для ревью
  • проверить условия перед созданием ветки или PR

Примеры запросов агенту

  • Предложи имя ветки и заголовок PR для добавления фильтра по статусу.
  • Создай ветку для исправления ошибки входа и предложи заголовок PR.
  • Открой черновик PR для обновления документации.

Как установить pr-branch-naming

1Через Skills CLI (Vercel)

npx skills add thedesignproject/agent-skills --skill pr-branch-naming -a claude-code

2Вручную: положить файлы

~/.claude/skills/pr-branch-naming/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/pr-branch-naming/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о pr-branch-naming

Как установить pr-branch-naming в Claude Code?

Выполни npx skills add thedesignproject/agent-skills --skill pr-branch-naming -a claude-code. Файл скилла находится по пути ~/.claude/skills/pr-branch-naming/SKILL.md.

Что делает pr-branch-naming?

По описанию изменения он предлагает имя ветки и заголовок PR. Создание ветки и черновика PR выполняет только после явного подтверждения.

Что нужно для работы pr-branch-naming?

Для операций с ветками нужен Git, а для создания PR — GitHub CLI gh с авторизацией. Если gh не авторизован, скилл предлагает выполнить gh auth login.

Исходный текст

SKILL.md · MIT
---
name: pr-branch-naming
description: Generate a conventionally-named branch and PR title from a feature description. Use when the user is starting a new branch, opening a PR, or asks how to name a branch or PR. Triggers on phrases like "create a branch", "name this branch", "open a PR", "what should I call this branch", "PR title for this".
argument-hint: [feature description]
allowed-tools: Read, Bash(git status:*), Bash(git branch:*), Bash(git checkout:*), Bash(git log:*), Bash(gh pr create:*), Bash(gh auth status:*)
---

# PR & Branch Naming

You generate a conventionally-named branch and a matching PR title from a feature description, then optionally check out the branch and/or open a PR — but only with explicit user confirmation.

---

## Step 1: Get the feature description

The user's input is in `$ARGUMENTS`. It can be:

1. **A description** — use it directly
2. **Empty** — try to infer the work from `git status` and the most recent commits (`git log -n 5 --oneline`). If you can infer it, propose it back to the user for confirmation. If not, ask: *"What's the feature or change this branch is for?"*

Don't fabricate a description. If there's nothing to go on, ask.

---

## Step 2: Pick the type and scope

### Type (one of)

| Type | When to use |
|---|---|
| `feat` | New feature or new UI work |
| `fix` | Bug fix to existing functionality |
| `docs` | Documentation changes only |
| `refactor` | Code restructuring with no behavior change |
| `perf` | Performance improvement |
| `chore` | Tooling, config, dependency bumps |
| `experimental` | Prototype, spike, or exploration not intended to ship as-is |

Pick the type that best matches the description. For designer-authored work, the common types are `feat` and `experimental`.

### Scope

The area of the product affected — short, lowercase, single word if possible. Examples: `playground`, `dashboard`, `auth`, `onboarding`, `billing`.

Infer the scope from the description. If it's genuinely ambiguous, ask once: *"What part of the product does this touch — dashboard, auth, etc.?"* Don't pepper the user with questions.

---

## Step 3: Pick the branch prefix

| Prefix | When to use |
|---|---|
| `feature/` | New features or UI work (pairs with `feat`) |
| `bugfix/` | Fixing existing functionality (pairs with `fix`) |
| `hotfix/` | Urgent production fixes |
| `docs/` | Documentation changes (pairs with `docs`) |
| `experimental/` | Prototypes and explorations (pairs with `experimental`) |

The prefix should align with the type. Use `feature/` for `feat`, `bugfix/` for `fix`, and so on.

---

## Step 4: Generate the names

### Branch name

Format: `<prefix>/<kebab-description>`

Rules:
- Lowercase only
- Hyphen-separated (no underscores, no spaces)
- No trailing hyphen
- Keep it concise — aim for 3–6 words in the description portion
- Drop filler words (`the`, `a`, `for`, `to`, `make`)

**Example:** `feature/patient-based-messaging`

### PR title

Format: `<type>(<scope>): <short description>`

Rules:
- Description in plain language, sentence case, no trailing period
- Concise — fits on one line
- Mirrors what the branch is about, but reads naturally to a human reviewer

**Example:** `feat(playground): v1 prototype — patient-based messaging flow`

---

## Step 5: Show the result

Present both names plus a one-line rationale, in this format:

```
Branch:    feature/patient-based-messaging
PR title:  feat(playground): v1 prototype — patient-based messaging flow

Type: feat (new UI work) · Scope: playground · Prefix: feature/
```

---

## Step 6: Offer to apply

Ask the user whether to:

1. **Check out the branch** — run `git checkout -b <branch>`
2. **Open a draft PR** — run `gh pr create --draft --title "<title>" --body "<one-line description>"`
3. **Do both**
4. **Neither** — they'll copy the names themselves

Before running either command, check the preconditions and stop with a clear message if they fail:

- **For `git checkout -b`:** run `git status` first. If the working tree is dirty, surface that and ask whether to proceed anyway, stash, or abort. If a branch with the same name already exists, suggest a numeric suffix (`-2`).
- **For `gh pr create`:** run `gh auth status` first. If unauthenticated, tell the user to run `gh auth login` and stop. Don't open the PR from a branch with no commits ahead of base — check with `git log <base>..HEAD --oneline` and warn if empty.

Never run destructive git operations (`reset --hard`, `branch -D`, `push --force`) as part of this skill.

---

## Notes

- If the user is already on a non-default branch when invoking this skill, ask whether the new branch should be cut from `main`/`master` or from the current branch.
- If multiple changes are described (e.g., "fix the login bug and add a new dashboard widget"), suggest splitting into two branches/PRs rather than smushing them into one.
- The PR title's description can use an em dash (`—`) to add a qualifier, as in the example. Don't overuse it.

© thedesignproject · MIT · thedesignproject/agent-skills

Похожие скиллы

Все скиллы по теме «Git и GitHub» →
finishing-a-development-branch Jesse Vincent Скилл finishing-a-development-branch проверяет тесты и помогает выбрать, как завершить работу в ветке: слить её, открыть Pull Request или оставить как есть. CX Codex +1 214 439установок create-branch getsentry Скилл create-branch для Claude Code создаёт Git-ветки по соглашениям Sentry. Он включается по просьбе создать ветку или при начале работы в ветке по умолчанию. CX Codex +1 4 400установок branch-finish sentimony Скилл branch-finish проверяет состояние Git и помогает безопасно завершить работу: слить изменения, открыть pull request, сохранить или удалить ветку. CX Codex +1 2 600установок new-branch-and-pr cursor Скилл new-branch-and-pr для Claude Code, Codex, Cursor и других агентов берёт задачу и проводит её по полному циклу: создаёт ветку от актуального main, делает коммит и открывает pull request. CX Codex +1 2 300установок gsd-pr-branch open-gsd Скилл gsd-pr-branch для Claude Code создаёт чистую ветку для пулл-реквеста, исключая коммиты из каталога .planning/. CX Codex +1 570установок conventional-branch официальный github Создаёт и проверяет ветки Git по спецификации Conventional Branch. Помогает соблюдать единые префиксы, например feature/ и bugfix/. CX Codex +1 243установок

Из того же набора13

Весь набор →
ux-audit Скилл ux-audit для Claude Code находит 3 главные проблемы UX на сайте или лендинге, исправляет их и готовит транскрипт Loom. CX Codex +1 ★ 107звёзд репо product-context-builder Скилл product-context-builder для Claude Code создаёт или обновляет файлы с контекстом продукта и проекта. Агент подключает его, когда нужно подготовить инструкции репозитория, описание продукта, дизайн-систему или проектные скиллы. CX Codex +1 ★ 107звёзд репо presentation Скилл presentation для Claude Code создаёт HTML-презентации из слайдов. Он включается по просьбе подготовить презентацию, питч-дек или показать материал в формате слайдов. CX Codex +1 ★ 107звёзд репо performance-review-self-assessment Скилл performance-review-self-assessment для Claude Code помогает подготовить самооценку к квартальному ревью. Он задаёт вопросы о результатах, трудностях, лидерских принципах и целях развития. CX Codex +1 ★ 107звёзд репо performance-review-manager Скилл performance-review-manager для Claude Code ведёт менеджера через квартальную оценку сотрудника. Он собирает отзывы коллег, помогает выставить рейтинги и обсудить развитие. CX Codex +1 ★ 107звёзд репо performance-review-360-peer Скилл performance-review-360-peer для Claude Code помогает составить отзыв коллеге по принципам ненасильственного общения. Он ведёт через вопросы о сильных сторонах, зонах роста и принципах лидерства. CX Codex +1 ★ 107звёзд репо create-skill Скилл create-skill для Claude Code помогает создавать скиллы Cursor и разбираться в структуре SKILL.md. Он включается при запросе на новый скилл или вопросе о его файле инструкций. CX Codex +1 ★ 107звёзд репо create-prd Скилл create-prd для Claude Code превращает запрос на функцию или расшифровку обсуждения в PRD. Он изучает кодовую базу и может создать проект с задачами в Linear. CX Codex +1 ★ 107звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой