Agent skill

Git Branch

by Terry-Mao in Terry-Mao/AICodingFlow

Create repository-compliant development branches with minimal safety checks.

MITAuto-check passedDevelopment

Install Git Branch

skills CLI
$ npx skills add Terry-Mao/AICodingFlow --skill git-branch -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Terry-Mao/AICodingFlow git-branch --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Terry-Mao/AICodingFlow.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/git-branch .claude/skills/git-branch && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
git-branch
GitHub stars
167
Token cost
~451 tokens
SKILL.md length
222 words
Files
2 (incl. references)
Skills in repo
30
Repo updated
First seen
Licence
MIT

At a glance

Create repository-compliant development branches with minimal safety checks.

  • Tasks that involve Git workflow
  • SKILL.md covers Naming and Create
  • Calls git

What it does

Git Branch is an agent skill from Terry-Mao/AICodingFlow. Create repository-compliant development branches with minimal safety checks.

Its SKILL.md is about 450 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/issue-id-examples.md`).

It sits in Development, covering Git workflow. The repository describes itself as: Setup a AI Coding Flow. The licence is MIT.

When your agent uses it

  • Tasks that involve Git workflow

Example prompts

  • “/git-branch”

What it can do on your machine

Read from SKILL.md and the folder at commit 7703e16. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • git

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use git, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Git Branch loads about 451 tokens when it runs, and up to ~614 if it reads all its reference files. Until then it costs about 22 tokens; SKILL.md has 222 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~22
When it runs · the whole SKILL.md, loaded when a task matches
~451
With references · SKILL.md plus every file in references/, read only if the agent opens them
~614

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Terry-Mao/AICodingFlow at commit 7703e16, republished under its MIT licence (© Terry-Mao). 222 words, ~451 tokens.

Download SKILL.mdSave it as .claude/skills/git-branch/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
git-branch
description
Create repository-compliant development branches with minimal safety checks.

git-branch

Create a new branch without overwriting work or choosing an unsafe base.

Naming

  • Issue-backed work: <type>/<short-desc>-<issueID>.
  • Other work: <type>/<user-provided-name>; never invent an issue ID.
  • Valid types are feat, fix, refactor, docs, test, perf, and chore. Preserve a valid user type, otherwise infer one and default to chore.
  • Keep the description short, lowercase, English, hyphen-separated, and valid for Git. Remove punctuation, filler, and repeated separators.

When an issue ID is provided, use one gh issue view <issueID> --json title,body,number call for naming context. If it fails, continue only when the request is enough and report that the issue was not verified.

Create

Check the current worktree, branch, and target branch first. Stop if the worktree intent is ambiguous, the target already exists, or the current/base branch is unsafe. Validate the name with:

bash
git check-ref-format --branch <branch-name>

Use the repository's documented base, otherwise main. In the same repository prefer origin/<base> over upstream/<base>; use upstream only for a fork or explicit guidance. Fetch or compare freshness only when it can change the choice of base. If creating from a stale local base, confirm before updating or use a freshly fetched remote base and report that the local base was unchanged.

bash
git switch -c <branch-name> <base>
git switch --no-track -c <branch-name> origin/<base>

Verify the resulting branch. Do not switch to an existing branch, overwrite, reset, stash, delete, or force anything without explicit user intent. Do not create protected/shared base branches.

© Terry-Mao, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in .agents/skills/git-branch of Terry-Mao/AICodingFlow.

  • SKILL.md
  • references/issue-id-examples.md

Open the folder on GitHubat commit 7703e16

Compare with similar skills

Git Branch next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Git Branch compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Git Branch this skillTerry-Mao/AICodingFlow167—~451Automated safety check: PassMIT
Finishing a Development Branchobra/superpowers296k5 repos~1.9kAutomated safety check: PassMIT
Code Design Rationale Investigatorcursor/plugins10k9 repos~2.6kAutomated safety check: PassNone
Contributor-First PR MergeHKUDS/OpenHarness16k1 repos~847Automated safety check: PassMIT
Migrate Internal Package into GhostTryGhost/Ghost55k—~3.8kAutomated safety check: PassMIT
Create Pull Requestcline/cline70k1 repos~1.6kAutomated safety check: PassApache-2.0

Similar skills

  • Walks the last step of a branch: confirm tests pass, detect the git environment, ask how to integrate, carry out your choice and clean up the worktree.

    296k GitHub starsUsed in 5 repos~1.9k tokens
    DevelopmentAuto-check passed
  • Official

    Digs into why code is shaped the way it is by checking git history, pull requests and connected tools in parallel, then reporting a cited read on the tradeoffs.

    10k GitHub starsUsed in 9 repos~2.6k tokens
    DevelopmentAuto-check passed
  • Merges external GitHub pull requests while keeping the original author credited, and fixes conflicts after the merge instead of rewriting the contribution.

    16k GitHub starsUsed in 1 repo~847 tokens
    DevelopmentAuto-check passed
  • Moves a package from another TryGhost repository into Ghost as an internal workspace package while keeping its Git history, with checkpoints for the steps that need an administrator.

    55k GitHub stars~3.8k tokensUpdated today
    DevelopmentAuto-check passed
  • Opens a GitHub pull request from your current branch with the gh CLI, after reviewing the commits and diff and gathering the details the PR needs.

    70k GitHub starsUsed in 1 repo~1.6k tokens
    DevelopmentAuto-check passed
  • Writes Conventional Commits whose bodies carry action lines recording the intent, decisions and constraints behind a change, not only what changed.

    29k GitHub starsUsed in 1 repo~2.7k tokens
    DevelopmentAuto-check passed

More from Terry-Mao/AICodingFlow

All 30 skills in this repo
  • PR Walkthrough

    Terry-Mao/AICodingFlow

    Generate a local static interactive D3 walkthrough of a pull request.

    167 GitHub stars~2.1k tokensUpdated 5 days ago
    Auto-check passed
  • Update PR Review

    Terry-Mao/AICodingFlow

    Improve repo-local PR review companion skills from human feedback on bot reviews.

    167 GitHub stars~1.1k tokensUpdated 5 days ago
    Auto-check passed
  • Implement Issue

    Terry-Mao/AICodingFlow

    Implement a GitHub issue in this repository by applying the local shared implement-specs workflow with repository-specific issue, spec-context, and summary-file handling.

    167 GitHub stars~2.3k tokensUpdated 5 days ago
    Auto-check passed
  • Implement Specs

    Terry-Mao/AICodingFlow

    Implement an approved feature from the repository's product and tech specs, keeping specs and code aligned in the same change as implementation evolves.

    167 GitHub stars~1.7k tokensUpdated 5 days ago
    Auto-check passed
  • Review PR

    Terry-Mao/AICodingFlow

    Review a GitHub pull request from pinned prdescription.txt, prdiff.txt, and optional speccontext.md snapshots, then write and validate review.json.

    167 GitHub stars~1k tokensUpdated 5 days ago
    Auto-check passed
  • Update Dedupe

    Terry-Mao/AICodingFlow

    Learn repo-local duplicate issue guidance from recent maintainer duplicate closures and propose updates to the dedupe companion skill.

    167 GitHub stars~1.1k tokensUpdated 5 days ago
    Auto-check passed

Categories

Questions about Git Branch

What does Git Branch do?

Create repository-compliant development branches with minimal safety checks. Git Branch is an agent skill from Terry-Mao/AICodingFlow. Create repository-compliant development branches with minimal safety checks.

When should I use Git Branch?

Git Branch fits situations like: tasks that involve Git workflow.

How do I install Git Branch in Claude Code?

Run `npx skills add Terry-Mao/AICodingFlow --skill git-branch -a claude-code`. Or copy the skill folder (.agents/skills/git-branch in Terry-Mao/AICodingFlow) into .claude/skills/git-branch in your project. Claude Code loads it when a task matches its description.

How do I install Git Branch in Codex?

Run `npx skills add Terry-Mao/AICodingFlow --skill git-branch -a codex`. Or copy the skill folder (.agents/skills/git-branch in Terry-Mao/AICodingFlow) into .agents/skills/git-branch in your project. Codex loads it when a task matches its description.

Can I use Git Branch in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Terry-Mao/AICodingFlow --skill git-branch -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/git-branch, .gemini/skills/git-branch, .github/skills/git-branch and .opencode/skills/git-branch in your project.

What does Git Branch need to run?

Going by SKILL.md and its folder, Git Branch needs the command-line tools its instructions call (git).

Does Git Branch access the network?

SKILL.md contains no URLs. Its commands use git, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Git Branch safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Git Branch use?

Git Branch is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Git Branch use?

About 451 tokens (SKILL.md is roughly 1.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 163 tokens, read only when the agent opens those files.

What are the alternatives to Git Branch?

Skills that share tags, products or a category with Git Branch: Finishing a Development Branch (obra/superpowers, 296k stars), Code Design Rationale Investigator (cursor/plugins, 10k stars), Contributor-First PR Merge (HKUDS/OpenHarness, 16k stars) and Migrate Internal Package into Ghost (TryGhost/Ghost, 55k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Git Branch?

Terry-Mao (a GitHub user) maintains it in Terry-Mao/AICodingFlow, which has 167 GitHub stars. The repository holds 30 skills in this directory. The repository was last updated on October 3, 2026.

Source: Terry-Mao/AICodingFlow on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.