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.