# commit-message

commit-message is a Claude Code skill that enforces structured commit formatting. Activates when asking the agent to commit changes or draft a commit note.

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

## What it does

The skill enforces a clear Git workflow before recording any changes. First, the agent inspects status and diffs. Next, it stages only relevant files instead of staging the entire workspace.

The summary line is capped at 72 characters in the imperative mood, followed by an optional description of what changed and why. Permitted prefixes are feat, fix, docs, refactor, test, and chore. The agent prints the draft and pauses for explicit approval before running the commit command.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add herdodp/snapgent-connector --skill commit-message -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add herdodp/snapgent-connector --skill commit-message -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add herdodp/snapgent-connector --skill commit-message -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install herdodp/snapgent-connector .snapgent/skills/commit-message
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add herdodp/snapgent-connector --skill commit-message -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/herdodp/snapgent-connector --path .snapgent/skills/commit-message
```

### Windsurf (Devin Desktop)

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

### 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/herdodp/snapgent-connector/tree/HEAD/.snapgent/skills/commit-message/SKILL.md

## When to use it
- stage only modified relevant files without adding workspace clutter
- format commit headers under 72 characters in imperative mood
- enforce allowed type prefixes across project history
- require manual user approval before executing git commit

## Example prompts
- Commit these fixes with a proper message
- Prepare a commit message for the refactored database module
- Check git diff and write the commit note for my tests

## Similar
- [commit-message-format](https://affpapa.org/en/nevibecode/rules/commit-message-format.md) — rule · ★ 359 repo stars
- [Conventional Commit Message Generator](https://affpapa.org/en/nevibecode/prompts/conventional-commit-message-generator.md) — prompt · ★ 178201 repo stars
- [git-commit](https://affpapa.org/en/nevibecode/skills/git-commit.md) — skill · 47165 installs
- [commit](https://affpapa.org/en/nevibecode/skills/getsentry-commit.md) — skill · 4900 installs
- [ce-commit](https://affpapa.org/en/nevibecode/skills/ce-commit.md) — skill · 3600 installs
- [conventional-commit](https://affpapa.org/en/nevibecode/skills/marcelorodrigo-conventional-commit.md) — skill · 964 installs

---
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
