skill CX Codex

git-workflow · netresearch — Claude Code skill: what it does, how to install

Q: How to install git-workflow in Claude Code?

Run `npx skills add netresearch/git-workflow-skill --skill git-workflow -a claude-code` in your terminal to install the skill.

Q: What tools are required to use git-workflow?

You need `git` and the `gh` CLI installed. Handling `.spec-cleanup.yml` also requires `yq`.

Automates branch workflows, Conventional Commits, and pull request checks. Guides agents through safe rebase steps and CI gates using GitHub CLI.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓

npx skills add netresearch/git-workflow-skill --skill git-workflow -a claude-code

Open on GitHub

What git-workflow does

This skill establishes strict policies for Git repositories and pull requests. It enforces Conventional Commits, blocks direct pushes to main, and mandates --force-with-lease over raw force-pushing. Merges cannot proceed until CI checks pass, commits are signed, and all review threads are marked resolved.

Under the hood, the skill supplies Bash automation. Scripts such as pr-status.sh inspect merge gates, pr-merge.sh handles signed fast-forward merges, and pr-sweep.sh automates bulk reviews. It also inspects repositories for hooks configured with lefthook, husky, captainhook, or pre-commit.

The built-in pull request automation targets GitHub GraphQL directly, which means git and gh CLI are required prerequisites. If you run GitLab, you must rely on manual glab commands documented in the reference files.

What it helps with

enforce Conventional Commits and atomic branch history
prevent merges while review comments remain unresolved
automate PR status checks and fast-forward merges
detect and configure git hooks across repositories

Example prompts for the agent

Check the current pull request gate using pr-status.sh
Format my staged changes into a conventional commit
Merge this PR with pr-merge.sh --self-reviewed

How to install git-workflow

1Skills CLI (Vercel)

npx skills add netresearch/git-workflow-skill --skill git-workflow -a claude-code

2Manually: put the files in place

~/.claude/skills/git-workflow/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/git-workflow/

1Skills CLI (Vercel)

npx skills add netresearch/git-workflow-skill --skill git-workflow -a codex

2Manually: put the files in place

.agents/skills/git-workflow/SKILL.md

For all projects use ~/.agents/skills/

1Skills CLI (Vercel)

npx skills add netresearch/git-workflow-skill --skill git-workflow -a cursor

2Manually: put the files in place

.cursor/skills/git-workflow/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install netresearch/git-workflow-skill git-workflow

2Manually: put the files in place

.github/skills/git-workflow/SKILL.md

1Skills CLI (Vercel)

npx skills add netresearch/git-workflow-skill --skill git-workflow -a gemini-cli

2Platform CLI

gemini skills install https://github.com/netresearch/git-workflow-skill --path skills/git-workflow

Manually: put the files in place

.devin/skills/git-workflow/SKILL.md

The legacy .windsurf/skills/ path still works

Skills CLI (Vercel)

npx skills add netresearch/git-workflow-skill --skill git-workflow -a opencode

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about git-workflow

How to install git-workflow in Claude Code?

Run npx skills add netresearch/git-workflow-skill --skill git-workflow -a claude-code in your terminal to install the skill.

What does git-workflow do?

It provides branch rules, Conventional Commit enforcement, and automated review gates for pull requests, preventing untested merges to main.

What tools are required to use git-workflow?

You need git and the gh CLI installed. Handling .spec-cleanup.yml also requires yq.

Similar skills

All skills for Git and GitHub →

git-workflow by other authors comes first.

git-workflow affaan-m A skill that hands your agent Git conventions: which branching strategy to pick, how to word commits, and when rebase beats merge. CX Codex +1 5,000installs git-workflow agno-team A skill that enforces best practices for commits, branch names, and pull requests. Includes commit message validation, branch naming templates, and PR checklist structure — useful if your team has git standards. CX Codex +1 665installs git-workflow ruvnet A skill that walks branches, conflicts and the pull request lifecycle, with a diff-risk score before every merge. CX Codex +1 743installs git-workflow Galaxy-Dawn Enforces Git standards: Conventional Commits, branch naming, no-ff merge flows, and conflict resolution. Useful for teams needing consistent version control habits. CX Codex +1 374installs git-workflow jezweb Guides Git work for pull requests, merged-branch cleanup, conflict resolution, and monorepo release tags in Claude Code. CX Codex +1 1,200installs conventional-git samber Enforces Conventional Commits v1.0.0 rules for branch names and commit messages. Useful for parseable git history and automated changelogs on GitHub and GitLab. CX Codex +1 4,600installs antfu-create-pr Anthony Fu Turns the current branch into a reviewable GitHub pull request: Conventional Commits title, evidence-based body, before/after screenshots for UI changes. CX Codex +1 485installs git-worktree-explorer official James Montemagno This plugin visualizes an active Git repository through worktrees, branches, and commits. Use it when you need a clear view of repository structure and pull request context. ★ 40,418repo stars create-pr NeoLabHQ Opens draft pull requests through the GitHub CLI using repository templates. It checks for uncommitted changes and formats PR titles with emojis. CX Codex +1 1,200installs git-commit fvadicamo A skill that writes git commits in Conventional Commits format with a type, a required scope and a short subject. Useful when the agent commits on your behalf. CX Codex +1 319installs