# committing-scoped-changes

committing-scoped-changes splits an explicit list of files or folders into separate git commits and leaves the rest of the working tree alone.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 153 installs · ★ 3 repo stars
- Author: b-mendoza
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/b-mendoza/agent-skills/tree/HEAD/skills/committing-scoped-changes/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/committing-scoped-changes

## What it does

You hand the skill a set of paths: exact files, or folders written with a trailing slash. Globs are rejected, spelling has to match the repository, and a rename counts only when both sides are listed.

It runs in two stages. A read-only subagent called `commit-boundary-planner` reads the state of the repo and writes a plan; you approve that plan in one go; then `scoped-commit-executor` commits one group at a time with `git commit --only -- <paths>`. Entries staged from elsewhere stay staged. The report format is checked by `scripts/validate-output.sh`.

Nothing gets committed until you ask for it in words in the current conversation. An unfinished merge, rebase, cherry-pick or bisect stops the run. Pushing and amending are not part of what it does.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add b-mendoza/agent-skills --skill committing-scoped-changes -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add b-mendoza/agent-skills --skill committing-scoped-changes -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add b-mendoza/agent-skills --skill committing-scoped-changes -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install b-mendoza/agent-skills skills/committing-scoped-changes
```

2. **Manually: put the files in place**
- File: `.github/skills/committing-scoped-changes/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add b-mendoza/agent-skills --skill committing-scoped-changes -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/b-mendoza/agent-skills --path skills/committing-scoped-changes
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add b-mendoza/agent-skills --skill committing-scoped-changes -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/b-mendoza/agent-skills/tree/HEAD/skills/committing-scoped-changes/SKILL.md

## When to use it
- commit only the files under `src/payments/` without disturbing what is already staged
- split a pile of edits into separate atomic commits
- keep unrelated experiments out of a ticket commit
- verify that no stray file slipped into the commit

## Example prompts
- Commit only the changes in `src/payments/` and `tests/payments.test.ts`, leave the rest alone.
- Split my working tree into atomic commits for `JNS-6880`.
- Make the commit for `src/checkout` in Conventional Commits style.

## Similar
- [git-workflow-and-versioning](https://affpapa.org/en/nevibecode/skills/git-workflow-and-versioning.md) — skill · 75700 installs
- [pull-changes-resolve-conflicts](https://affpapa.org/en/nevibecode/skills/pull-changes-resolve-conflicts.md) — skill · 1900 installs
- [git-workflow](https://affpapa.org/en/nevibecode/skills/bobmatnyc-git-workflow.md) — skill · 574 installs
- [atomic-commits](https://affpapa.org/en/nevibecode/rules/atomic-commits.md) — rule · ★ 2966 repo stars
- [commit-commands](https://affpapa.org/en/nevibecode/plugins/rohitg00-commit-commands.md) — plugin · ★ 2858 repo stars
- [semantic-git](https://affpapa.org/en/nevibecode/skills/semantic-git.md) — skill · 201 installs

From the same set: [b-mendoza/agent-skills](https://affpapa.org/en/nevibecode/by/b-mendoza/agent-skills.md) — 12 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
