How do I install the Gitflow skill?

Run npx skillmds@latest add jzills/gitflow in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Gitflow skill do?

Use when the repository has been identified as using GitFlow — a remote `develop` branch exists. Provides base branches, PR targets, and merge conventions for feature, release, and hotfix branches. It is listed under Coding & Dev Tools on SkillMD.

Is Gitflow safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Gitflow?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Gitflow free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Gitflow?

jzills (@jzills) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Gitflow by jzills — Agent Skill

Name: Gitflow
Author: jzills

File contents

GitFlow Branching Conventions

Branch Routing

Branch type	Cut from	PR targets	Notes
`feature/`, `fix/`, `chore/`, `refactor/`, `docs/`, `test/`, `ci/`, `perf/`, `style/*`	`develop`	`develop`	Day-to-day work
`release/*`	`develop`	`main` (default branch)	Back-merge (`main` → `develop`) is CI/CD's responsibility post-merge
`hotfix/*`	`main` (default branch)	`main` (default branch)	Critical production fixes; CI/CD back-merges to `develop`

Creating a Branch

Always pull the base branch before cutting:

git checkout <base-branch> && git pull origin <base-branch>
git checkout -b <new-branch>
git push -u origin <new-branch>

Resolving the Default Branch

GitFlow repos may use main or master as the production branch. Always resolve dynamically — never hardcode:

gh repo view --json defaultBranchRef --jq '.defaultBranchRef.name'

Use this value wherever main appears in the table above.

Detection Signal

This strategy was identified because git ls-remote --heads origin develop returned output. If that is no longer true, switch to branching-strategy:trunk.

Frequently asked questions

Gitflow