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

semantic-git — скилл для Claude Code: коммиты и установка

Скилл semantic-git для Claude Code группирует связанные изменения в атомарные коммиты и оформляет сообщения в Conventional Commits. Готовит изменения к коммиту.

MIT 201 установок ★ 22 обновлён 2026-03-21

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

Что делает semantic-git

Перед коммитом скилл предлагает проверить типы, тесты и линтинг. Если проверка падает, он останавливается и сообщает об этом, не переходя к индексации файлов. Затем группирует связанные изменения, например код и тесты, и предлагает короткое сообщение в формате Conventional Commits.

Скилл показывает точные команды git add и git commit и спрашивает, запускать ли их агенту или вручную. До выполнения нужно одобрение пользователя; перед следующим коммитом агент тоже просит подтверждение. Даже при доступном zagi выводятся обычные команды git, которые могут обрабатываться через алиас или оболочку.

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

  • разбить изменения на связанные атомарные коммиты
  • подобрать сообщение в формате Conventional Commits
  • показать команды для индексации файлов и коммита
  • проверить проект перед индексацией изменений

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

  • Подготовь изменения к коммиту: проверь проект и сгруппируй связанные файлы.
  • Предложи сообщение Conventional Commits и покажи команды, не запускай их без моего разрешения.
  • Сделай отдельный коммит только для тестов и сначала покажи команды.

Как установить semantic-git

1Через Skills CLI (Vercel)

npx skills add siviter-xyz/dot-agent --skill semantic-git -a claude-code

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

~/.claude/skills/semantic-git/SKILL.md

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

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

Вопросы о semantic-git

Как установить semantic-git в Claude Code?

Выполните npx skills add siviter-xyz/dot-agent --skill semantic-git -a claude-code. Файл скилла находится в ~/.claude/skills/semantic-git/SKILL.md.

Что делает semantic-git?

Он помогает подготовить атомарные коммиты, предлагает сообщения Conventional Commits и показывает команды Git до запуска. Коммит выполняется только после явного согласия пользователя.

Что произойдёт, если проверка CI завершится ошибкой?

Скилл остановится и сообщит о проблеме, не переходя к индексации файлов.

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

SKILL.md · MIT
---
name: semantic-git
description: Manage Git commits using conventional commit format with atomic staging. Always generate plain git commands before running them and offer to let the user run them manually.
---

# Semantic Git

Manage Git commits using conventional commit format with atomic commits and concise messages.

This skill is **zagi-aware** and is designed to work well with AI IDEs (Cursor, etc.)

## Tooling

- **Preferred**: [`zagi`](https://github.com/mattzcarey/zagi) (a better git interface for agents).
  - Assume zagi is installed if:
    - `git` is aliased to zagi in the shell **or**
    - a `zagi` binary is available.
  - When in doubt, treat `git` as if it may be zagi-compatible and avoid using exotic flags.
  - Even when zagi is available, **generate plain `git` commands** and let any `git` → `zagi` integration handle them.
- **Fallback**: plain `git` when zagi is not available.

## When to Use

- Committing changes to git
- Staging files for commit
- Creating commit messages
- Managing atomic commits
- Before pushing changes

## Core Principles

- **Atomic commits**: Stage and commit related changes together. Tests go with implementation code.
- **User confirmation**: Always confirm with user before committing and before moving to the next commit.
- **Conventional format**: Use conventional commit message format (feat, fix, etc.) unless directed otherwise.
- **Concise messages**: Keep messages brief and to the point. Omit description unless change is complicated.
- **Command transparency**: Always show the exact `git` commands that will be run (which may be handled by zagi via alias/wrapper), and ask whether the user wants:
  - to run them manually, or
  - to have the agent run them.

## Commit Message Format

```
<type>[optional scope]: <subject>

[optional body]

[optional footer(s)]
```

### Types

- `feat`: A new feature
- `fix`: A bug fix
- `docs`: Documentation only changes
- `style`: Changes that do not affect the meaning of the code (white-space, formatting, missing semi-colons, etc.)
- `refactor`: A code change that neither fixes a bug nor adds a feature
- `perf`: A code change that improves performance
- `test`: Adding missing tests or correcting existing tests
- `build`: Changes that affect the build system or external dependencies
- `ci`: Changes to CI configuration files and scripts
- `chore`: Maintenance tasks (updating build tasks, dependencies, etc.; no production code change)
- `revert`: Revert a previous commit

### Breaking Changes

Use `!` after the type/scope to indicate breaking changes:
- `feat!: add new API`
- `fix(api)!: change response format`

### Subject Line

- Use imperative mood: "add feature" not "added feature" or "adds feature"
- First letter lowercase (unless starting with proper noun)
- No period at the end
- Keep under 72 characters when possible

### Body and Footer

- Omit body unless change is complicated or requires explanation
- When needed, be concise and reference issues, PRs, or documentation
- Use footer for breaking changes: `BREAKING CHANGE: <description>`

## Workflow

1. **Implement atomic change**: Code + tests together.
   - Use `test:` for test-only changes.
2. **Run CI checks**: Verify types, tests, and linting pass before staging.
   - Prefer a single CI command if it exists (e.g., `pnpm ci`, `npm run ci`, `just ci`).
   - If no CI command, run checks individually (typecheck, test, lint).
   - If any check fails, stop and report – do not proceed.
3. **Stage atomic changes**: Group related files together (implementation + tests).
4. **Suggest commit message**: Generate a conventional commit message based on changes.
5. **Generate commands**:
   - Construct explicit shell commands using `git` (which may be an alias or wrapper such as zagi), for example:

     ```bash
     git add path/to/file1 path/to/file2
     GIT_AUTHOR_DATE="YYYY-MM-DD HH:MM:SS" \
     GIT_COMMITTER_DATE="YYYY-MM-DD HH:MM:SS" \
     git commit -m "feat: add feature"
     ```

   - Always **print these commands** to the user in order.
6. **Ask for execution preference**:
   - Ask the user whether they want:
     - to copy-paste and run the commands themselves, or
     - to have the agent run them.
   - Only execute commands after explicit user approval.
7. **Commit**:
   - When executing, run **exactly** the printed commands.
   - Respect any user instructions about backdating timestamps or additional flags.
8. **Next commit**:
   - Before staging the next set of changes, confirm with the user that the previous commit is complete and understood.

## Automation Mode

If user requests "continue to X" or "automate until X":

- Proceed with atomic commits automatically, **but still print commands**.
- For each commit:
  - Show the staging and commit commands.
  - Optionally execute them automatically, as per the user’s automation request.
- Resume asking for confirmation when X is reached.
- X can be: specific file, feature completion, test passing, etc.

## Stop and Ask Protocols

Stop and ask user before:

- Adding type ignores (`@ts-ignore`, `# type: ignore`, etc.).
- Adding suppressions (ESLint disable, pylint disable, etc.).
- Using `any` type or similar type escapes.
- When uncertain how to proceed with implementation.
- When requirements are unclear.
- When a destructive git operation is proposed (`reset --hard`, `checkout .`, `clean -f`, `push --force`); prefer safer alternatives and explain the risks.

## Examples

**Simple feature or behaviour change:**
```
feat: add user authentication
```

**Feature with scope:**
```
feat(api): add user endpoint
```

**Bug fix:**
```
fix: resolve memory leak in cache
```

**Breaking change:**
```
feat!: migrate to new API version
```

**Test-only change:**
```
test: improve unit tests for auth service
```

**Refactor (no behavior change):**
```
refactor: extract validation logic into separate function
```

**Complex change (with body):**
```
feat(api): add pagination support

Implements cursor-based pagination for large datasets.
See docs/api/pagination.md for details.
```

## References

For detailed guidance, see:

- `references/conventional-commits.md` – Commit format and examples
- `references/ci-verification.md` – CI check patterns and verification
- `references/co-authors.md` – Handling Co-Authored-By trailers and zagi co-author stripping

© siviter-xyz · MIT · siviter-xyz/dot-agent

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

Все скиллы по теме «Git и GitHub» →
semantic-versioning aj-geddes Скилл semantic-versioning для автоматического версионирования по SemVer: conventional commits, semantic-release и генерация changelog. CX Codex +1 554установок git-workflow affaan-m Скилл git-workflow с готовыми правилами Git: какую стратегию ветвления выбрать, как писать коммиты и когда rebase лучше merge. CX Codex +1 6 800установок conventional-git samber Скилл conventional-git задаёт правила именования веток и коммитов по стандарту Conventional Commits v1.0.0. Помогает поддерживать чистую историю проекта в GitHub и GitLab. CX Codex +1 5 400установок git-pushing sickn33 Скилл git-pushing отправляет коммиты по стандарту Conventional Commits в удалённую ветку через изолированный индекс Git. Защищает от случайного захвата лишних файлов при рядовых пушах. CX Codex +1 932установок git-hygiene-enforcer patricio0312rev Скилл git-hygiene-enforcer для Claude Code задаёт правила коммитов и веток, готовит шаблон PR и описывает процесс ревью. Он приводит Git-процесс проекта к общим правилам. CX Codex +1 271установок

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

Весь набор →
software-engineer Скилл software-engineer задаёт агенту правила стиля кода, документации и рабочего процесса: без лишних комментариев, без самовольных git-коммитов, с вопросами при неясностях. CX Codex +1 637установок python Задаёт единый стиль Python: типизация, внедрение зависимостей, структура тестов и модулей. Держит код в одном порядке при правках в существующем проекте. CX Codex +1 353установок create-agents-md Скилл create-agents-md помогает составить файл AGENTS.md с точечными правилами для репозитория. Пригодится при настройке стиля кода, команд сборки и ограничений для ИИ-агентов. CX Codex +1 306установок typescript Скилл typescript для Claude Code задаёт стандарты написания и изменения кода на TypeScript. Активируется при работе с файлами TypeScript и TypeScript React. CX Codex +1 239установок cli-building Скилл cli-building задаёт правила создания консольных утилит: асинхронный ввод-вывод, модульная композиция команд и форматирование терминального вывода с учётом NO_COLOR. CX Codex +1 201установок debugging Скилл debugging для Claude Code пошагово ищет первопричину сбоев и ошибок в коде. Помогает локализовать баг и подготовить минимальное исправление. CX Codex +1 151установок media-processing Скилл media-processing для Claude Code автоматизирует пакетную обработку медиа: сжатие видео, ресайз картинок и конвертацию аудио через FFmpeg и ImageMagick. CX Codex +1 151установок psi psi ведёт разработку через план, спецификацию и реализацию с тестами. Скилл запускается только по прямой просьбе или по упоминанию в AGENTS.md. CX Codex +1 144установок

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

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