Unverified Commit 1720b9bb authored by Tobias Koppers's avatar Tobias Koppers Committed by GitHub

docs(skills): use agent-agnostic branch prefix in create-pr (#99934)

## Summary

The `create-pr` skill is shared by every coding agent working in this
repo, but it hard-coded the `codex/` branch prefix, so Claude, Fleet,
and other agents were told to name branches as if they were Codex.

The skill now uses an agent-agnostic `<agent-name>/<short-topic>`
convention: agents prefix branches with their own name as a single
lowercase word, with `codex/`, `claude/`, and `fleet/` given as
examples. The user can still override the name. The frontmatter
description is updated to match so skill matching still covers branch
naming. The Codex-app git directive guidance is left as is, since it is
genuinely Codex-specific.

## Verification

- `prettier --check .agents/skills/create-pr/SKILL.md`
- `git diff --check`

<!-- NEXT_JS_LLM -->


<!-- fleet e712205b-2273-4aec-9b25-14aeb34efaba -->
Co-authored-by: 's avatarvercel-fleet-prod[bot] <318278635+vercel-fleet-prod[bot]@users.noreply.github.com>
Co-authored-by: 's avatarTobias Koppers <1365881+sokra@users.noreply.github.com>
parent d3a60807
...@@ -5,7 +5,7 @@ description: > ...@@ -5,7 +5,7 @@ description: >
Use when the user asks to create a branch, commit current changes, open a Use when the user asks to create a branch, commit current changes, open a
PR or draft PR, publish a pull request, or recover from gh pr create / PR PR or draft PR, publish a pull request, or recover from gh pr create / PR
template issues. Covers .github/pull_request_template.md, --body formatting, template issues. Covers .github/pull_request_template.md, --body formatting,
codex/ branch names, and Codex app git directives. <agent-name>/ branch names, and Codex app git directives.
metadata: metadata:
internal: true internal: true
--- ---
...@@ -39,10 +39,12 @@ details, and give them the GitHub URL to create the PR themselves. See ...@@ -39,10 +39,12 @@ details, and give them the GitHub URL to create the PR themselves. See
2. Create or confirm the branch: 2. Create or confirm the branch:
```bash ```bash
git switch -c codex/<short-topic> git switch -c <agent-name>/<short-topic>
``` ```
Use the `codex/` prefix unless the user asks for a different name. If a Prefix the branch with your agent's name as a single lowercase word, such
as `codex/`, `claude/`, or `fleet/` (e.g. `claude/<short-topic>`), unless
the user asks for a different name. If a
`.git/*lock` or `Operation not permitted` error appears, rerun the same Git `.git/*lock` or `Operation not permitted` error appears, rerun the same Git
command with sandbox escalation. Do not assume a branch namespace conflict command with sandbox escalation. Do not assume a branch namespace conflict
until checking refs with `git branch --list`, `git show-ref`, or until checking refs with `git branch --list`, `git show-ref`, or
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment