| name | git-branch-creator |
| description | Create a new Git branch from the latest core branch (`main` or `develop`, whichever is available). Use when the user asks to create a new branch, start a feature branch, or checkout a working branch. Requires the new branch name; if it is missing, return a message asking for it and stop. |
| argument-hint | new-branch-name [optional base branch] |
Git Branch Creator
Create and switch to a new Git branch safely.
When this skill fits
Use it for requests like:
- "create a new branch feature/login-form"
- "start a branch called bugfix/token-refresh"
- "checkout a new branch for this task"
Do not use it for:
- merging or rebasing branches
- deleting branches
- opening pull requests
Workflow
1. Require a branch name
Check whether a branch name was supplied after the skill call.
If it is missing, respond with:
A new branch name should be specified for this skill.
Then stop the skill execution.
2. Ensure the repository is ready
- Confirm the workspace is inside a Git repository.
- Auto-detect the core branch (
main preferred, then develop) unless the user clearly requests another base.
- If not already on the base branch, switch to it first.
3. Update the base branch
Run the helper script:
pwsh -NoProfile -File ./.github/skills/git-branch-creator/scripts/create-branch.ps1 -BranchName "<new-branch-name>"
The script will:
- fetch from
origin
- check whether the selected base branch is behind
origin/<base>
- pull with
--ff-only if updates are needed
- stop if the requested branch already exists
4. Create the branch
After the base branch is ready, create and switch to the new branch using the provided branch name.
Hard rules
- Never invent the branch name.
- If the name is missing, stop immediately.
- Prefer
git switch semantics for branch creation.
- Use
--ff-only when updating the base branch.
- Return the exact git result instead of guessing success.
