conventional-commitslisted
Install: claude install-skill stealth-engine/skills
# Conventional Commits (a.k.a. semantic commit messages)
A commit convention that makes history **machine-readable**: a parser reads each
message, decides the next semver version, and builds the changelog from it. "Semantic
commits" is the common nickname for the same thing. It's the foundation the release
automation stands on — [`semantic-release-automation`](../semantic-release-automation/SKILL.md)
covers the tooling that consumes these messages.
## The format
```text
<type>[(<scope>)][!]: <description>
<optional body — the "why", wrapped>
<optional footer(s) — BREAKING CHANGE:, Closes #123, Refs: ABC-12>
```
- `type` / `scope`: lowercase **by convention** — the spec is case-*insensitive*,
except `BREAKING CHANGE`, which MUST be uppercase. `scope` is an optional noun in
parens for the area touched.
- `!` before the colon **or** a `BREAKING CHANGE:` footer marks a breaking change
(`BREAKING-CHANGE:` with a hyphen is an accepted synonym).
- **description**: concise; **by convention** imperative mood, lowercase, **no
trailing period** (Angular/commitlint style — the spec itself mandates none of
these).
- Blank line before any body/footer.
```text
feat(auth): add passkey sign-in
fix(parser): handle empty input without throwing
feat(api)!: drop the v1 token endpoint
docs: fix typo in install steps
```
## Types → meaning → version bump
These are the **semantic-release defaults** (the `angular` preset plus
commit-analyzer's built-in release rules). They're confi