Agent skill

Gitflow

by CJ-Systems in CJ-Systems/gitflow-cjs

Run Vincent Driessen's git-flow branching model — start feature branches, and (later) finish them, cut releases, and ship hotfixes.

No licenceAuto-check passedDevelopment

Install Gitflow

skills CLI
$ npx skills add CJ-Systems/gitflow-cjs --skill gitflow -a claude-code

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

GitHub CLI
$ gh skill install CJ-Systems/gitflow-cjs gitflow --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/CJ-Systems/gitflow-cjs.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/gitflow .claude/skills/gitflow && 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
gitflow
GitHub stars
123
Token cost
~2.5k tokens
SKILL.md length
1,090 words
Files
4 (incl. scripts)
Skills in repo
1
Repo updated
First seen
Licence
None found

At a glance

Run Vincent Driessen's git-flow branching model — start feature branches, and (later) finish them, cut releases, and ship hotfixes.

  • Works in 5 steps: Don't quote raw JSON or git output.… → Prefer the words the user thinks in.… → Name files and branches. Concrete beats… → …
  • The user asks to start a feature
  • SKILL.md covers What's available so far, When this skill runs, Operating principle — agent… and feature start — invocation, plus 4 more sections
  • Runs Python scripts from its folder; calls git and python3

What it does

Gitflow is an agent skill from CJ-Systems/gitflow-cjs. Run Vincent Driessen's git-flow branching model — start feature branches, and (later) finish them, cut releases, and ship hotfixes. Trigger when the user asks to "start a feature," "create a gitflow branch," "kick off feature X," or otherwise wants gitflow workflow operations on a git repository.

Its SKILL.md is about 2.5k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including scripts (for example `BACKGROUND.md`, `scripts/feature_start.py` and `scripts/init.py`).

It sits in Development, covering Git workflow. It works with Git. The repository describes itself as: CJS Edition of the git extensions to provide high-level repository operations for Vincent Driessen's branching model.

When your agent uses it

  • The user asks to start a feature
  • Create a gitflow branch
  • Kick off feature X
  • Otherwise wants gitflow workflow operations on a git repository

Example prompts

  • “start a feature,”
  • “create a gitflow branch,”
  • “kick off feature X,”
  • “/gitflow”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Don't quote raw JSON or git output. Translate.
  2. Prefer the words the user thinks in. "Project" over "git repository." "Unsaved changes" over "uncommitted changes." Workflow vocabulary…
  3. Name files and branches. Concrete beats vague.
  4. Always suggest the next move. Every message has a remedy or a question — never a dead-end.
  5. Stay terse. Two sentences max for an error. Calm and direct.

What it can do on your machine

Read from SKILL.md and the folder at commit 1e0be1d. 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

    Ships 2 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • git
    • python3

    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

Gitflow loads about 2.5k tokens when it runs. Until then it costs about 76 tokens; SKILL.md has 1,090 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~76
When it runs · the whole SKILL.md, loaded when a task matches
~2.5k

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); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 1,090 words (~2,534 tokens).

“This is the gitflow skill. When a user wants to run a gitflow operation on their project, this file tells you how to invoke the workflow scripts in scripts/ and how to translate their results into user-facing voice.”

— opening of SKILL.md by CJ-Systems
name
gitflow

Read the full SKILL.md on GitHub

Files

SKILL.md and 3 other files (scripts) in skills/gitflow of CJ-Systems/gitflow-cjs.

  • SKILL.md
  • BACKGROUND.md
  • scripts/feature_start.py
  • scripts/init.py

Open the folder on GitHubat commit 1e0be1d

Compare with similar skills

Gitflow 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.

Gitflow compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gitflow this skillCJ-Systems/gitflow-cjs123—~2.5kAutomated safety check: PassNone
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
  • Git Merge Conflict Resolver

    tailcallhq/forgecode

    Resolves Git merge conflicts with a plan-first workflow that keeps both sides' intent, regenerates lock files and backs up deleted-but-modified files.

    7.6k GitHub starsUsed in 1 repo~4.5k tokens
    DevelopmentAuto-check passed

Works with

Categories

Questions about Gitflow

What does Gitflow do?

Run Vincent Driessen's git-flow branching model — start feature branches, and (later) finish them, cut releases, and ship hotfixes. Gitflow is an agent skill from CJ-Systems/gitflow-cjs. Run Vincent Driessen's git-flow branching model — start feature branches, and (later) finish them, cut releases, and ship hotfixes.

When should I use Gitflow?

Gitflow fits situations like: the user asks to start a feature; create a gitflow branch; kick off feature X; otherwise wants gitflow workflow operations on a git repository.

How do I install Gitflow in Claude Code?

Run `npx skills add CJ-Systems/gitflow-cjs --skill gitflow -a claude-code`. Or copy the skill folder (skills/gitflow in CJ-Systems/gitflow-cjs) into .claude/skills/gitflow in your project. Claude Code loads it when a task matches its description.

How do I install Gitflow in Codex?

Run `npx skills add CJ-Systems/gitflow-cjs --skill gitflow -a codex`. Or copy the skill folder (skills/gitflow in CJ-Systems/gitflow-cjs) into .agents/skills/gitflow in your project. Codex loads it when a task matches its description.

Can I use Gitflow 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 CJ-Systems/gitflow-cjs --skill gitflow -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/gitflow, .gemini/skills/gitflow, .github/skills/gitflow and .opencode/skills/gitflow in your project.

What does Gitflow need to run?

Going by SKILL.md and its folder, Gitflow needs Python for the scripts in its folder and the command-line tools its instructions call (git and python3). Our summary lists: Python 3.

Does Gitflow 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 Gitflow 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Gitflow use?

No licence was found for Gitflow or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Gitflow use?

About 2.5k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Gitflow?

Skills that share tags, products or a category with Gitflow: 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 Gitflow?

CJ-Systems (a GitHub organization) maintains it in CJ-Systems/gitflow-cjs, which has 123 GitHub stars. The repository was last updated on May 16, 2026.

Source: CJ-Systems/gitflow-cjs on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.