# conventional-commit

Скилл для ИИ-агентов, который заставляет их писать коммиты по спецификации Conventional Commits: тип, scope, императив в заголовке.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 953 установки · ★ 19
- Автор: marcelorodrigo
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/marcelorodrigo/agent-skills/tree/HEAD/skills/conventional-commit/SKILL.md
- Обновлён: 2026-09-03
- HTML: https://affpapa.org/nevibecode/skills/marcelorodrigo-conventional-commit

## Что делает

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

Перед коммитом скилл просит проверить текущую ветку через `git branch --show-current`. Если вы на `main` или `master`, сначала создаётся ветка по шаблону `<type>/<short-description>`, где тип совпадает с типом коммита. Ломающие изменения помечаются `!` после типа или футером `BREAKING CHANGE:`. Для отката есть отдельный формат `revert:` с указанием хеша и причины.

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

Ставится одной командой `npx skills add` для шести платформ, включая Claude, Codex и Cursor.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add marcelorodrigo/agent-skills --skill conventional-commit -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add marcelorodrigo/agent-skills --skill conventional-commit -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add marcelorodrigo/agent-skills --skill conventional-commit -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install marcelorodrigo/agent-skills conventional-commit
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add marcelorodrigo/agent-skills --skill conventional-commit -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/marcelorodrigo/agent-skills --path skills/conventional-commit
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add marcelorodrigo/agent-skills --skill conventional-commit -a opencode
```

### Claude.ai

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

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

## Когда брать
- написать коммит по Conventional Commits без сверки со спецификацией
- разбить правку на один стабильный и обозримый коммит
- пометить ломающее изменение API через `!` или `BREAKING CHANGE:`
- оформить откат коммита с указанием хеша и причины
- завести ветку с именем, совпадающим с типом изменения

## Примеры запросов агенту
- закоммить изменения в user API по conventional commits
- сделай коммит для новой фичи алертов, scope alerts
- оформи revert коммита abc123def456 с причиной

## Похожие
- [commit](https://affpapa.org/nevibecode/skills/getsentry-commit.md) — скилл · 4700 установок
- [ce-commit](https://affpapa.org/nevibecode/skills/ce-commit.md) — скилл · 3400 установок
- [conventional-commit-message](https://affpapa.org/nevibecode/skills/conventional-commit-message.md) — скилл · 946 установок
- [Conventional Commit Message Generator](https://affpapa.org/nevibecode/prompts/conventional-commit-message-generator.md) — промпт · ★ 174597
- [conventional-commits](https://affpapa.org/nevibecode/skills/conventional-commits.md) — скилл · 469 установок

## Другие версии с тем же именем
- [conventional-commit · github](https://affpapa.org/nevibecode/skills/conventional-commit.md) — 17103 установки

Из того же набора: [marcelorodrigo/agent-skills](https://affpapa.org/nevibecode/by/marcelorodrigo/agent-skills.md) — 2 карточки

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

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