Branch Naming Skill

Generate and validate Git branch names from conventional commit messages or plain descriptions. This skill only handles naming -- it does not create, delete, or manage branches.

Instructions

Step 1: Parse Input

Determine the commit type and subject from whatever the user provides.

If a conventional commit message (e.g., feat: add user auth):

• Extract type, optional scope, and subject
• Pattern: <type>[optional scope]: <description>

If a plain description (e.g., add user authentication):

• Infer type from keywords (see references/type-mapping.md for full mapping)
• Keywords: add/implement/create -> feat, fix/resolve/correct -> fix, document/readme -> docs, refactor/restructure -> refactor, test/spec -> test, remove/delete/update -> chore
• Default to feat when no keywords match