# woocommerce-git-commit

woocommerce-git-commit prepares clean Git commits following WooCommerce conventions, splits changelog entries, and stages specific files without pushing.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 121 installs · ★ 10608 repo stars
- Author: woocommerce
- License: GPL-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/woocommerce/woocommerce/tree/HEAD/.ai/skills/woocommerce-git-commit/SKILL.md
- Updated: 2026-10-25
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/woocommerce-git-commit

## What it does

This skill inspects your workspace using status commands and diff summaries. It defaults to a single commit when work belongs together, yet isolates independent edits into separate batches. Changes under changelog folders never bundle with core application code.

Messages follow strict imperative style under 72 characters with verbs like Fix, Add, or Refactor. Issue numbers stay out of commit titles because squash merges in GitHub manage tracking later. The agent prints a preview of planned commits before staging any files.

Mass additions via `git add .` are blocked, and the tool never invokes `git push`. Linters do not run here, so you must verify PHP checks through `woocommerce-dev-cycle` before triggering the commit flow.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add woocommerce/woocommerce --skill woocommerce-git-commit -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/woocommerce-git-commit/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/woocommerce-git-commit/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add woocommerce/woocommerce --skill woocommerce-git-commit -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/woocommerce-git-commit/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add woocommerce/woocommerce --skill woocommerce-git-commit -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/woocommerce-git-commit/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install woocommerce/woocommerce .ai/skills/woocommerce-git-commit
```

2. **Manually: put the files in place**
- File: `.github/skills/woocommerce-git-commit/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add woocommerce/woocommerce --skill woocommerce-git-commit -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/woocommerce/woocommerce --path .ai/skills/woocommerce-git-commit
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/woocommerce-git-commit/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add woocommerce/woocommerce --skill woocommerce-git-commit -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/woocommerce/woocommerce/tree/HEAD/.ai/skills/woocommerce-git-commit/SKILL.md

## When to use it
- split unrelated working tree changes into atomic commits
- separate changelog documentation from source code modifications
- generate clear commit summaries under 72 characters
- prevent accidental staging of unreviewed files

## Example prompts
- commit my changes following repo conventions
- save my work in git
- commit this cart fix

## Similar
- [git-commit](https://affpapa.org/en/nevibecode/skills/eduardo-sl-git-commit.md) — skill · ★ 90 repo stars
- [git-conventional-commit-messages](https://affpapa.org/en/nevibecode/rules/git-conventional-commit-messages.md) — rule · ★ 41178 repo stars
- [commit-helper](https://affpapa.org/en/nevibecode/skills/commit-helper.md) — skill · 714 installs
- [writing-commit-messages](https://affpapa.org/en/nevibecode/skills/writing-commit-messages.md) — skill · 499 installs
- [conventional-commit](https://affpapa.org/en/nevibecode/skills/conventional-commit.md) — skill · 17103 installs
- [commit-message-storyteller](https://affpapa.org/en/nevibecode/skills/commit-message-storyteller.md) — skill · 392 installs

From the same set: [woocommerce/woocommerce](https://affpapa.org/en/nevibecode/by/woocommerce/woocommerce.md) — 9 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
