git-branch

What I do

• Detect the repository default branch from origin/HEAD, then fall back to local main, master, or develop
• Review the current session context plus staged and unstaged git changes to infer the branch purpose
• Generate a short branch name in <type>/<brief-description> format
• Create and switch to the new branch while preserving local changes when safe
• Ask the user instead of guessing when the intent or safe branching base is ambiguous

When to use me

Use this skill when the user asks to create a new git branch for the current work and wants the branch name derived from the session context and current git changes.

Prerequisites

• git must be installed
• Use git switch when available; if the installed Git is too old to support it, use git checkout / git checkout -b instead
• The repository should have a detectable default branch from origin/HEAD or local main, master, or develop
• If the current branch is not the detected default branch and the worktree is dirty, ask the user before switching branches

Default Branch Detection

1. Check the current branch:

   git branch --show-current
   

2. Detect the remote default branch first:

   default_branch="$(git symbolic-ref --quiet --short refs/remotes/origin/HEAD 2>/dev/null)"
   default_branch="${default_branch#origin/}"
   

3. If the remote default branch is unavailable, fall back in this order:

   for candidate in main master develop; do
     if git show-ref --verify --quiet "refs/heads/$candidate"; then
       default_branch="$candidate"
       break
     fi
   done
   

4. If no default branch can be determined, stop and ask the user which branch should be used as the base.

Change Analysis

1. Review the current agent session context and the user's latest request.
2. Inspect the current git-visible work:

   git status --short
   git diff --cached --stat
   git diff --stat
   

3. Prefer the user request and session goal over raw filenames when naming the branch.
4. Use changed files and diff summaries as supporting context to infer the branch type and slug.
5. If there are no local changes yet, derive the branch name from the session goal alone.