Créez et validez des branches Git en utilisant une convention de nommage standardisée pour définir l'objectif et identifier l'agent IA utilisé.
- Étoiles GitHub
- 41 038
- Fichiers
- 1
- Dernier commit
- 11 nov. 2026
- Licence
- MIT
- Outils autorisés
- —
Que fait la skill conventional-branch ?
Créez et validez des branches Git en utilisant une convention de nommage standardisée pour définir l'objectif et identifier l'agent IA utilisé.
Résumé généré à partir du SKILL.md de la skill.
À propos du skill conventional-branch
Cette SKILL permet de standardiser le nommage des branches Git pour les équipes de développement et les agents de codage IA. Elle offre une méthode structurée pour créer et valider des branches en utilisant des préfixes spécifiques tels que feature, bugfix, hotfix, release ou chore. Elle inclut également des préfixes spécialisés pour identifier le travail généré par des outils IA spécifiques comme Claude, Copilot, Cursor ou Codex.
Un agent doit charger cette SKILL lorsqu'il doit initialiser une nouvelle tâche de développement ou vérifier si le nom d'une branche existante respecte les spécifications. Le processus consiste à déterminer le type de branche approprié, à valider le nom selon des règles strictes concernant l'usage des lettres minuscules et des caractères, et à détecter la branche principale locale ou distante comme main ou develop. La SKILL génère un nom de branche correctement formaté et exécute les commandes git checkout nécessaires pour préparer l'environnement de travail.
Ce qu'un agent peut faire avec
- 1Créer une branche feature standardiséeGénérez une nouvelle branche pour une tâche spécifique en utilisant le préfixe correct et une description en kebab-case.
- 2Identifier le travail généré par une IAÉtiquetez les branches créées par des assistants de codage spécifiques afin de maintenir une provenance claire dans le dépôt.
- 3Valider les noms de branches existantsVérifiez si le nom d'une branche respecte les règles de nommage, telles que l'obligation d'utiliser des minuscules et les restrictions de caractères.
Rédigé à partir du SKILL.md du skill. Chaque cas d'utilisation est vérifié par rapport à une citation de celui-ci.
Comment installer la skill conventional-branch
Chaque commande copie le dossier de la skill dans le répertoire des skills du client. Redémarrez le client ou démarrez une nouvelle session pour la charger.Installer la skill conventional-branch dans Claude Code
~/.claude/skills/conventional-branch/SKILL.md
$ npx degit github/awesome-copilot/skills/conventional-branch ~/.claude/skills/conventional-branchInstaller la skill conventional-branch dans Claude Code (project)
.claude/skills/conventional-branch/SKILL.md
$ npx degit github/awesome-copilot/skills/conventional-branch .claude/skills/conventional-branchInstaller la skill conventional-branch dans Codex
~/.agents/skills/conventional-branch/SKILL.md
$ npx degit github/awesome-copilot/skills/conventional-branch ~/.agents/skills/conventional-branchInstaller la skill conventional-branch dans Gemini CLI
~/.gemini/skills/conventional-branch/SKILL.md
$ npx degit github/awesome-copilot/skills/conventional-branch ~/.gemini/skills/conventional-branchInstaller la skill conventional-branch dans Claude.ai
npx degit github/awesome-copilot/skills/conventional-branch conventional-branch && zip -r conventional-branch.zip conventional-branch # claude.ai → Customize → Skills → + → Create skill → Upload a skill → conventional-branch.zip
Vérifications automatisées
Exécuté le 15 nov. 2026Rapport complet →A réussi nos vérifications automatiques. Ce n'est pas un audit de sécurité : lisez les scripts avant de laisser un agent les exécuter. Fonctionnement des vérifications
- Dépôt source lié et accessiblegithub/awesome-copilot/skills/conventional-branch is public and reachablegithub.com/github/awesome-copilot/tree/HEAD/skills/conventio ↗Réussi
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit 2026-11-11github.com/github/awesome-copilot/commits ↗Réussi
- Aucun téléchargement-exécution ni vol d'identifiants dans les scriptsNo scripts in the skill folderRéussi
- Aucune instruction cachée dans SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/github/awesome-copilot/blob/HEAD/skills/conventio ↗Réussi
- Les outils préautorisés sont limitésNo pre-approved tools; the agent asks before using onegithub.com/github/awesome-copilot/blob/HEAD/skills/conventio ↗Réussi
- SKILL.md respecte le format Agent SkillsValid name and description; says when to use it; 164 linesgithub.com/github/awesome-copilot/blob/HEAD/skills/conventio ↗Réussi
SKILL.md
Voir sur GitHubConventional Branch
Create Git branches that follow the Conventional Branch specification — a simple, consistent convention for naming Git branches.
Branch Name Format
<type>/<description>
Branch Types
Purpose prefixes — describe the intent of the work:
| Type | Alias | Purpose |
|---|---|---|
feature/ |
feat/ |
New features or enhancements |
bugfix/ |
fix/ |
Bug fixes |
hotfix/ |
— | Urgent production fixes |
release/ |
— | Release preparation (dots allowed in version: release/v1.2.0) |
chore/ |
— | Non-code tasks (deps, docs, config) |
AI agent source prefixes — identify branches generated by AI coding agents:
| Type | Alias | Purpose |
|---|---|---|
ai/ |
— | Generic prefix for any AI coding agent |
copilot/ |
— | GitHub Copilot |
cursor/ |
— | Cursor |
claude/ |
— | Claude Code by Anthropic |
codex/ |
— | OpenAI Codex |
Use a vendor-specific prefix when you know which agent is producing the branch; use ai/ as a vendor-neutral fallback.
Trunk Branches
main, master, and develop are trunk branches — they do not use a prefix. Never create new branches with the same names as trunk branches; branch off them instead.
Naming Rules
- Lowercase only — no uppercase letters anywhere
- Alphanumerics, hyphens, and dots —
a-z,0-9,-,. - Dots are allowed in any description, typically for version numbers (e.g.,
release/v1.2.0,chore/upgrade-node-v20.11) - No underscores, spaces, or special characters
- No consecutive hyphens (
--), dots (..), or hyphen-dot adjacency (-.or.-) - No leading or trailing hyphens or dots in the description
Valid Examples
main
master
develop
feature/add-login-page
feat/add-login-page
bugfix/fix-header-bug
fix/header-bug
hotfix/security-patch
release/v1.2.0
chore/update-dependencies
feature/issue-123-new-login
ai/refactor-auth-flow
copilot/add-login-page
cursor/fix-header-bug
claude/security-patch
codex/optimize-query
Invalid Examples
| Branch | Problem |
|---|---|
Feature/Add-Login |
Uppercase letters |
feature/new--login |
Consecutive hyphens |
feature/-new-login |
Leading hyphen |
feature/new-login- |
Trailing hyphen |
release/v1.-2.0 |
Hyphen adjacent to dot |
fix/header bug |
Space |
fix/header_bug |
Underscore |
unknown/some-task |
Unknown prefix type |
Description Guidelines
- Use kebab-case with 2-5 words
- Be descriptive but concise (~50 chars total)
- Good:
add-oauth-login,fix-header-overflow,update-ci-config - Bad:
fix-bug,new-feature
Workflow
Follow these steps:
Step 1 — Determine Branch Type
Ask the user (if not already clear):
- Branch type — default to
featurewhen uncertain - Brief description — what the branch is for
If the user mentions a ticket or issue number, include it in the description (e.g., feature/issue-123-add-oauth).
Step 2 — Validate the Name
Check the assembled name against the Naming Rules above. If any rule fails, fix it:
- Lowercase everything
- Replace underscores and spaces with hyphens
- Collapse consecutive hyphens
- Strip leading/trailing hyphens
Step 3 — Detect the Base Branch
Different repos use different trunk branches. Detect which one this repo uses:
# Prefer the remote's default branch
git symbolic-ref --short refs/remotes/origin/HEAD 2>/dev/null | sed 's|^origin/||'
If that returns nothing, check which trunk branch exists locally (priority order: develop, main, master):
for b in develop main master; do
git show-ref --verify --quiet "refs/heads/$b" && echo "$b" && break
done
Step 4 — Create and Checkout
git checkout <base>
git pull origin <base>
git checkout -b <type>/<description>
Step 5 — Confirm
Tell the user:
- The branch name that was created
- That they are now on the new branch
- Remind them:
git push -u origin <branch-name>when ready
Validation
commit-check validates branch names against the specification. Run commit-check --branch, use its check-branch pre-commit hook, or commit-check-action in GitHub Actions. Configuration for GitHub rulesets, GitLab, Bitbucket and Git hooks is at https://conventionalbranch.org/enforce/.
Relationship with Conventional Commits
Conventional Branch complements Conventional Commits:
| Conventional Branch | Typical Conventional Commit |
|---|---|
feature/add-login |
feat: add login page |
bugfix/fix-header |
fix: header overflow on mobile |
chore/update-deps |
chore: bump lodash to 5.0 |
release/v1.2.0 |
chore: release v1.2.0 |
Align the branch type with commit types where possible (e.g., feature/* branches with feat: commits).
Fichiers de cette skill
1Questions sur la skill conventional-branch
Comment installer la skill conventional-branch dans Claude Code ?
Exécutez npx degit github/awesome-copilot/skills/conventional-branch ~/.claude/skills/conventional-branch. Claude Code charge les skills depuis ~/.claude/skills (tous les projets) ou .claude/skills (un seul projet) et utilise une skill lorsque sa description correspond à la tâche.
Quels clients peuvent utiliser la skill conventional-branch ?
Tout client qui lit le format Agent Skills : Claude Code, Codex, Gemini CLI et claude.ai (envoi sous forme de ZIP). Les scripts de la skill ne s'exécutent que si le client autorise l'exécution de code.