Git workflow

Skill pablodiazjorge/prompt-forge/packages/custom/.github/skills/git-workflow

Git best practices for AI coding agents. Use when committing changes, creating branches, splitting PRs, reviewing code, or setting up worktrees. Covers Conventional Commits v1.0.0 spec, atomic commits, stacked PRs, squash-based workflow, and worktree patterns.From its SKILL.md

Install

npx -y skills add pablodiazjorge/prompt-forge --skill git-workflow

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
runs commandsInstructs the agent to run 8 commands, including `git add -p` and 7 more.

What its file declares

Copied from the file, not written here

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

2.5 KB, 572 tokens by cl100k_base, as published. Nobody here has run it

Git Workflow

Conventional Commits v1.0.0

<type>[optional scope][!]: <description>

[optional body]

[optional footer(s)]

Types

Type	SemVer	Use
`feat`	MINOR	New feature
`fix`	PATCH	Bug fix
`docs`	—	Documentation only
`style`	—	Formatting, no logic change
`refactor`	—	Code change, no fix/feature
`perf`	—	Performance improvement
`test`	—	Adding/correcting tests
`chore`	—	Build, deps, tooling
`ci`	—	CI/CD config
`revert`	—	Reverting commits

BREAKING CHANGE (MAJOR)

Two valid forms per spec:

feat(api)!: send email on shipment       # ! before :

feat: allow config extension

BREAKING CHANGE: `extends` key now used for extending configs

Revert

revert: let us never speak of the noodle incident

Refs: 676104e, a215868

Atomic Commits

One logical change per commit. Use git add -p for interactive staging:

git add -p                     # Stage hunks interactively
git add src/models/            # Stage specific directory

Good: "Add user model and validation" / Bad: "Add user model, fix navbar bug, update readme"

PR Splitting (Stacked PRs)

PR 1 (base): Models, interfaces, types
PR 2 (logic): Services, state management
PR 3 (UI): Components, templates, styles
PR 4 (tests): Unit/integration tests

Each PR compiles independently. Squash-based workflow: lead maintainer cleans commit messages on merge.

Branch Naming

feature/<name>   fix/<name>   refactor/<name>   docs/<name>   chore/<name>

Worktrees (for PR reviews)

git worktree add -b review-pr-42 ../review feature/branch
git worktree list
git worktree remove ../review

Stashing

git stash                              # Quick
git stash push -m "WIP: refactoring"   # Named
git stash --include-untracked          # + untracked
git stash --staged                     # Only staged
git stash pop                          # Apply latest

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.