К основному содержанию
скилл CX Codex

conventional-commits · tigrisdata — скилл для Claude Code

Форматирует коммиты по спецификации Conventional Commits, добавляет атрибуцию ИИ и требует флаг --signoff для фиксации изменений в Git.

MIT 105 установок ★ 2 обновлён 2026-07-23

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add tigrisdata/skills --skill conventional-commits -a claude-code
Открыть на GitHub

Что делает conventional-commits

Скилл задаёт строгий формат сообщений коммитов: тип (feat, fix, docs, refactor и другие), опциональный скоуп в скобках и краткое описание в повелительном наклонении строчными буквами без точки на конце. Тело коммита отделяется пустой строкой, переносится по 72 символам и объясняет причину изменений, а не сам код. Ломающие изменения помечаются знаком восклицания после типа либо блоком BREAKING CHANGE: в подвале.

В инструкциях прописано обязательное требование: каждый коммит должен содержать флаг --signoff для подтверждения Developer Certificate of Origin (DCO). Если коммит подготовлен с участием ИИ, скилл добавляет в подвал строку атрибуции вида Assisted-by: [Model Name] via [Tool Name], связывает тикеты через Closes: и помогает автоматизировать генерацию CHANGELOG.md.

Какие задачи решает

  • сформировать сообщение коммита по правилам Conventional Commits
  • разметить ломающие изменения для автоматического семантического версионирования
  • добавить отметку об участии нейросети в подвал коммита
  • проставить подпись Developer Certificate of Origin через флаг signoff

Примеры запросов агенту

  • Сделай коммит с изменениями в модуле авторизации, исправлена ошибка с null ответом сервера
  • Подготовь текст коммита для рефакторинга обработчиков ошибок в ядре
  • Оформи коммит с мажорным изменением API списка корзин и укажи, что закрыт тикет 123

Как установить conventional-commits

1Через Skills CLI (Vercel)

npx skills add tigrisdata/skills --skill conventional-commits -a claude-code

2Вручную: положить файлы

~/.claude/skills/conventional-commits/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/conventional-commits/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о conventional-commits

Как установить conventional-commits в Claude Code?

Выполните в терминале команду npx skills add tigrisdata/skills --skill conventional-commits -a claude-code. Файл спецификации сохранится по пути ~/.claude/skills/conventional-commits/SKILL.md.

Что делает скилл conventional-commits?

Он направляет языковую модель при создании коммитов в Git: валидирует типы изменений, форматирует заголовки без точек и заглавных букв, следит за переносом строк в теле коммита и формирует подвалы с ссылками на задачи.

Зачем в этом скилле используется атрибуция ИИ?

Правила скилла обязывают ассистента явно раскрывать помощь модели в подвале коммита строкой Assisted-by: Model via Tool, чтобы история репозитория оставалась прозрачной.

Исходный текст

SKILL.md · MIT
---
name: conventional-commits
description: Use when creating git commits, writing commit messages, or following version control workflows
---

# Conventional Commits

Structured commit message format for version control that provides clear, readable project history.

## Overview

The Conventional Commits specification provides:

- **Automated changelog generation** - Tools can parse commits to generate CHANGELOG.md
- **Semantic versioning** - Commit types map to version bumps (feat → minor, breaking → major)
- **Clear project history** - Standardized format makes git log readable
- **Automated releases** - CI/CD can trigger releases based on commit types

## Quick Reference

| Type | Use For | Version Bump |
| ---- | ------- | ------------ |
| `feat` | New feature | MINOR |
| `fix` | Bug fix | PATCH |
| `docs` | Documentation only | PATCH |
| `style` | Formatting, no logic change | PATCH |
| `refactor` | Code restructuring, no behavior change | PATCH |
| `perf` | Performance improvement | PATCH |
| `test` | Adding or updating tests | PATCH |
| `build` | Build system or dependencies | PATCH |
| `ci` | CI/CD configuration | PATCH |
| `chore` | Maintenance, no user-facing change | PATCH |
| `revert` | Revert a previous commit | PATCH |

## Format

```text
<type>[optional scope]: <description>

[optional body]

[optional footer(s)]
```

**Rules:**

- Type is required
- Scope is optional - use parenthesized section affected: `(api)`, `auth)`, `parser)`
- Description is required
- Keep description concise, imperative mood, lowercase, no trailing period
- Body and footer are optional
- Separate subject from body with blank line
- Wrap body at 72 characters

## Examples

```text
feat: add user authentication

Implement JWT-based authentication with login/logout endpoints.
Includes password hashing and session management.

Closes: #123
```

```text
fix(api): handle null response from server

Previous implementation crashed when server returned null.
Now returns empty result set.

Assisted-by: GLM 4.6 via Claude Code
```

```text
feat(storage)!: change bucket listing API

BREAKING CHANGE: bucket list now returns async iterator
instead of array. Update all callers to use for-await.
```

```text
refactor(core): simplify error handling

Consolidate duplicate error handlers into single utility.
No behavior changes - internal cleanup only.
```

```text
revert: feat(auth): add OAuth support

This reverts commit 8b5a1c2. OAuth provider changed
their API and we need to redesign integration.
```

## Breaking Changes

Indicate breaking changes in two ways:

**Option 1**: Add `!` after type/scope

```text
feat(api)!: remove deprecated endpoint
```

**Option 2**: Add `BREAKING CHANGE:` footer

```text
feat(api): remove deprecated endpoint

BREAKING CHANGE: endpoint no longer exists. Use newEndpoint instead.
```

## AI Attribution

AI agents must disclose their assistance in the commit footer:

```text
Assisted-by: [Model Name] via [Tool Name]
```

Examples:

- `Assisted-by: GLM 4.6 via Claude Code`
- `Assisted-by: Claude Opus 4.5 via claude.ai`

## Common Mistakes

| Mistake | Why Wrong | Correct |
| ------- | --------- | ------- |
| `Added login feature` | Past tense, capitalized | `feat: add login feature` |
| `fix bug.` | Trailing period | `fix: resolve login error` |
| `update` | Missing type | `chore: update dependencies` |
| `feature:add-auth` | Missing space after colon | `feat: add authentication` |
| `FEAT: big change` | Uppercase type | `feat: add authentication` |
| Multi-line description no blank line | No separation | Add blank line after subject |

## Body Guidelines

- **What**: Motivation for the change (vs. code comments describe HOW)
- **Contrast**: Explain the WHY and WHAT, not code details
- **Wrap at 72 characters** for readability in git log

```text
feat(summarization): add support for nested bullet points

Previous implementation only flattened all content. Now preserves
hierarchy by respecting indentation levels. Users can now create
structured summaries with parent-child relationships.

Closes: #456
```

## Footer Guidelines

Use footers for:

- **Breaking changes**: `BREAKING CHANGE: detailed explanation`
- **Issue references**: `Closes: #123`, `Fixes: #456`, `Refs: #789`
- **AI attribution**: `Assisted-by: Model via Tool`

Multiple footers separated by blank lines:

```text
feat: add batch upload

Implements multipart upload for large files.

BREAKING CHANGE: upload() signature changed - now requires options object
Closes: #123
Assisted-by: GLM 4.6 via Claude Code
```

## Git Commit Flags

**Required flag:** Always use `--signoff` when committing:

```bash
git commit --signoff -m "feat: add user authentication"
```

The `--signoff` flag adds a `Signed-off-by` trailer to the commit message, indicating the committer has certified the commit follows developer certificate of origin (DCO).

## Testing Your Commit

Before committing, verify:

1. [ ] Type is from allowed list
2. [ ] Description is imperative mood (add, fix, update)
3. [ ] Description is lowercase
4. [ ] No trailing period on description
5. [ ] Breaking changes marked with `!` or footer
6. [ ] AI attribution included (if applicable)
7. [ ] Body explains WHY not HOW
8. [ ] Using `--signoff` flag

© tigrisdata · MIT · tigrisdata/skills

Похожие скиллы

Все скиллы по теме «Git и GitHub» →

Сначала — conventional-commits от других авторов.

conventional-commits patricio0312rev Пишет коммиты по спецификации Conventional Commits: тип, область, тело и футеры. Обеспечивает автоматический версионинг и changelog. CX Codex +1 504установок atomic-commits Rohit Ghumare Правило atomic-commits задаёт правила работы с Git: атомарные коммиты по Conventional Commits, запрет прямых правок в main и выборочную индексацию файлов. CX Codex +1 ★ 2 966звёзд репо commits itechmeat Помогает агенту оформлять Git-коммиты по Conventional Commits с учётом breaking changes. Формат используют для changelog и SemVer. CX Codex +1 178установок conventional-commit-message dangreen Скилл conventional-commit-message формирует сообщения коммитов по стандарту Conventional Commits 1.0.0 и пресету conventionalcommits. Помогает готовить описания изменений, пригодные для автогенерации changelog. CX Codex +1 1 100установок smart-commit rohitg00 Плагин smart-commit автоматически создаёт коммиты в формате Conventional Commits с семантическим анализом изменений. Генерирует чейнджлоги и упрощает историю проекта. ★ 2 858звёзд репо conventional-git samber Скилл conventional-git задаёт правила именования веток и коммитов по стандарту Conventional Commits v1.0.0. Помогает поддерживать чистую историю проекта в GitHub и GitLab. CX Codex +1 5 400установок conventional-commit официальный github Генерирует сообщения коммитов в формате Conventional Commits. Запускается после изменений в репозитории и сам собирает коммит по XML-шаблону. CX Codex +1 17 103установок

Из того же набора11

Весь набор →
tigris-agent-kit Скилл tigris-agent-kit для работы с объектным хранилищем Tigris: изолированные копии датасетов, бакеты под каждого агента, снапшоты и вебхуки. CX Codex +1 3 800установок tigris-s3-migration Скилл tigris-s3-migration для Claude Code ведёт миграцию объектного хранилища с AWS S3, GCS или Azure Blob на Tigris. Переключает бакет без остановки продакшена через shadow bucket, массовое копирование или инкрементальный синк. CX Codex +1 3 800установок tigris-static-assets Скилл tigris-static-assets настраивает выгрузку статики в хранилище Tigris с глобальной раздачей через CDN, заголовками Cache-Control и интеграцией с веб-фреймворками. CX Codex +1 3 800установок tigris-image-optimization Скилл tigris-image-optimization для работы с картинками в Tigris: режет варианты при загрузке, отдаёт их через публичный бакет и подсказывает настройки под ваш фреймворк. CX Codex +1 3 800установок tigris-sdk-guide Скилл tigris-sdk-guide подсказывает агенту, какой SDK или CLI выбрать для Tigris: родной для TypeScript, Go и Python, AWS-совместимый для Ruby и PHP. CX Codex +1 3 800установок file-storage Скилл file-storage помогает настроить бакеты Tigris через консоль и встроить загрузку файлов в Node.js, Rails или Laravel. CX Codex +1 3 800установок tigris-snapshots-forking Скилл tigris-snapshots-forking для Claude Code, Codex, Cursor и других агентов: создаёт снапшоты бакетов Tigris и форкает их как изолированные копии. Данные в форке удаляются независимо от источника — исходный бакет остаётся нетронутым. CX Codex +1 453установок tigris-bucket-management Скилл tigris-bucket-management помогает управлять бакетами в Tigris Storage: создавать публичные или приватные хранилища, настраивать регионы, проверять свойства и удалять корзины. CX Codex +1 135установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой