
Git Workflow
A comprehensive Git workflow skill that enforces modern development practices through eight reference documents covering everything from branching strategies to CI/CD integration. The non-negotiable rules are worth noting: no direct pushes to main, no merges until review threads are resolved, and preservation of atomic commits over squashing to maintain GPG signatures. It auto-detects hook frameworks like lefthook and husky, supports Conventional Commits out of the box, and includes a verification script to validate your setup. The merge gate workflow and signed commit handling are particularly well thought out. If you're tired of explaining Git best practices to your team or want to codify your workflow, this gives you a solid foundation to build on.
- skills.sh installs
- 743
- GitHub stars
- 59
- last updated
- Aug 21, 2026
Install
$ npx -y skills add netresearch/git-workflow-skill --skill git-workflow --agent claude-codeInstalls into .claude/skills of the current project.
Files
Git Workflow Skill
Not Here
Releases: github-release. BLOCKED-PR diagnosis: github-project.
GitHub only. Everything below the branching and commit sections — pr-status.sh, pr-merge.sh, the merge gate, review threads — speaks GitHub GraphQL. For a GitLab merge request the equivalent glab calls are in references/pull-request-workflow.md § GitLab: the same gate with glab.
Critical Rules (Non-Negotiable)
- No direct push to main — always open a PR.
- No merge before all threads resolved (
references/pull-request-workflow.md). - No squash unless asked — preserves atomic commits, signatures, bisection.
- No "tested/verified/working" without pasted command output — else say so.
- No edits to installed skill/plugin cache paths (
~/.claude/skills/,~/.claude/plugins/cache/,**/.bare/**) — always the repo worktree, verified bypwd. - Force-push only with
--force-with-lease— never plain--force. - Commit before rebase —
add → commit → fetch → rebase → push(a dirty tree aborts it). - No editorializing — state what changed, not how good it is (
references/no-editorializing.md).
Reference Files
Sponsors
Details
- Repository
- github.com/netresearch/git-workflow-skill
- Categories
- Frontend Development, DevOps & CI/CD, Git & Pull Requests, Code Review & Quality, Release Management, Debugging, Automation & Workflows
- First seen
- Jun 3, 2026