# Commit

> Use when preparing, reviewing, or suggesting git commit messages or pull request titles, or before creating a commit.

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

---


# Commit and PR title conventions

Commit messages and PR titles must be prefixed with exactly one emoji that describes the primary intent of the change.

Prefer the most user-visible category when a commit spans multiple areas.

## Emoji prefixes

- `🐛` Fix a bug.
- `✨` New user-facing feature. Use this only for a meaningful feature users would actively want to try. Use it sparingly. If the change is incremental rather than substantial, prefer `👌`. Use only when there is a frontend change.
- `👌` New user-facing addition to an existing feature, such as a new option or small capability. Use only when there is a frontend change.
- `🔧` New internal implementation. Use when the change is mostly internal and not directly noticeable by end users.
- `♻️` Refactoring. Use when behavior stays effectively the same and the main goal is code cleanup or restructuring.
- `💅` UI or UX update. Use when the main value is visual polish, interaction quality, or layout improvements.
- `📝` Blog or documentation update.

## Before committing

Always check the diff and remove debug logs, temporary files, commented-out experiments, and other temporary artifacts before creating a commit.

## After opening a PR

Never amend commits that are already part of an opened PR. Push follow-up fixes as new commits so review history and existing comments remain stable.

## Format

Use a concise imperative or descriptive title after the emoji:

```text
🐛 Fix workspace invite redirect
🔧 Add billing sync worker
♻️ Simplify block schema helpers
```