# Commit

> Create conventional commit messages. Use when the user says "commit this", "save changes", "git commit", asks to commit code, write a commit message, or format git history. Follows conventional commits specification.

- Skill: `poteto/commit` (Agent Skill)
- Install (CLI): `npx skillmds add poteto/commit`
- Raw SKILL.md: https://api.skillmd.com/api/skills/poteto/commit/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: poteto (https://skillmd.com/u/poteto)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/poteto/commit

---


# Conventional Commits

Follow these project-specific rules when creating commits.

## Branching

**Never create bare branches.** If you need branch isolation, use the `worktree` skill. For simple changes, commit directly on the current branch (including main). Do not run `git checkout -b`.

## Project Rules

- **One commit per logical change** — never combine unrelated fixes or features. Three independent changes = three commits.
- **Only commit files you changed** — never pull in unrelated files from concurrent sessions.
- **Always include a body** — no title-only commits. Explain what and why.
- **`merge` type** — use `merge` (not a merge commit) when merging a worktree or feature branch.
- **Sequence commits** to maximise option value — foundational infrastructure first, then features that build on it.

## Example

```
feat(alerts): Add Slack thread replies for alert updates

When an alert is updated or resolved, post a reply to the original
Slack thread instead of creating a new message. This keeps related
notifications grouped together.
```

## References

- [Conventional Commits Specification](https://www.conventionalcommits.org/en/v1.0.0/#specification)