# Conventional Commits

> Format all commit messages per the Conventional Commits v1.0.0 spec. Use when creating commits, reviewing commit messages, or discussing git workflow. Use when this capability is needed.

- Skill: `tomevault-io/conventional-commits-6` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/conventional-commits-6`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/conventional-commits-6/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/conventional-commits-6

---


# Conventional Commits

Spec: https://www.conventionalcommits.org/en/v1.0.0/

## Format

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

[optional body]

[optional footer(s)]
```

## Types

- `feat` — new feature (SemVer MINOR)
- `fix` — bug fix (SemVer PATCH)
- Also permitted: `build`, `chore`, `ci`, `docs`, `style`, `refactor`, `perf`, `test`

## Rules

- Scope is optional, in parentheses: `feat(parser):`
- Description MUST immediately follow the colon and space
- Body is optional, separated by one blank line from description
- Footers are optional, separated by one blank line from body
- Breaking changes: add `!` before colon OR use `BREAKING CHANGE:` footer (SemVer MAJOR)
- `BREAKING CHANGE` MUST be uppercase
- Footer tokens use hyphens for spaces (e.g., `Acked-by`)

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/simpleapps-com) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-14 -->