# writing-commit-messages

Скилл задаёт агенту формат conventional commits: тип, scope, тело и футер. Пригодится, когда сообщения коммитов пишет модель, а не человек.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 454 установки · ★ 866
- Автор: spencerpauly
- Лицензия: CC0-1.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/spencerpauly/awesome-cursor-skills/tree/HEAD/resources/writing-commit-messages/SKILL.md
- Обновлён: 2026-08-02
- HTML: https://affpapa.org/nevibecode/skills/writing-commit-messages

## Что делает

Скилл описывает формат `<type>(<optional scope>): <subject>` и таблицу типов: `feat`, `fix`, `refactor`, `docs`, `test`, `chore`, `perf`, `style`, `ci`, `revert`. Для строки темы правило простое — до 50 знаков, повелительное наклонение, без точки в конце и без заглавной буквы после префикса. В теле скилл советует объяснять причину изменения, а не пересказывать диф.

Отдельно разобраны ломающие изменения: восклицательный знак после типа и строка `BREAKING CHANGE:` в футере с инструкцией по миграции. Есть блок про то, когда коммитить — одна логическая правка на коммит, рефакторинг не мешать с новой функциональностью, неполный код не коммитить, а прятать в `git stash`.

Скилл текстовый: это один файл `SKILL.md` без скриптов и внешних зависимостей. Работает он ровно настолько, насколько агент следует инструкции, — жёсткого валидатора сообщений внутри нет, так что в проектах с собственным commitlint возможны расхождения по длине строки или списку разрешённых типов.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add spencerpauly/awesome-cursor-skills --skill writing-commit-messages -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/writing-commit-messages/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/writing-commit-messages/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add spencerpauly/awesome-cursor-skills --skill writing-commit-messages -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/writing-commit-messages/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add spencerpauly/awesome-cursor-skills --skill writing-commit-messages -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/writing-commit-messages/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install spencerpauly/awesome-cursor-skills writing-commit-messages
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/writing-commit-messages/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add spencerpauly/awesome-cursor-skills --skill writing-commit-messages -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/spencerpauly/awesome-cursor-skills --path resources/writing-commit-messages
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/writing-commit-messages/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add spencerpauly/awesome-cursor-skills --skill writing-commit-messages -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/spencerpauly/awesome-cursor-skills/tree/HEAD/resources/writing-commit-messages/SKILL.md

## Когда брать
- писать сообщения коммитов в едином формате conventional commits
- выбрать правильный тип для правки: feat, fix или chore
- описать в теле коммита причину изменения, а не пересказ дифа
- пометить ломающее изменение и дописать инструкцию по миграции
- разделить рефакторинг и новую функциональность по разным коммитам

## Примеры запросов агенту
- Напиши сообщение коммита для этих изменений по conventional commits
- Разбей текущий диф на отдельные логические коммиты и подпиши каждый
- Это ломающее изменение — оформи коммит с пометкой BREAKING CHANGE

## Похожие
- [conventional-commit](https://affpapa.org/nevibecode/skills/conventional-commit.md) — скилл · 17103 установки
- [conventional-commits](https://affpapa.org/nevibecode/skills/conventional-commits.md) — скилл · 469 установок
- [git-commit-helper](https://affpapa.org/nevibecode/skills/git-commit-helper.md) — скилл · 7093 установки
- [commit](https://affpapa.org/nevibecode/skills/getsentry-commit.md) — скилл · 4700 установок
- [ce-commit](https://affpapa.org/nevibecode/skills/ce-commit.md) — скилл · 3400 установок
- [git-commit](https://affpapa.org/nevibecode/skills/ilteoood-git-commit.md) — скилл · 533 установки

Из того же набора: [spencerpauly/awesome-cursor-skills](https://affpapa.org/nevibecode/by/spencerpauly/awesome-cursor-skills.md) — 59 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md