Conventional Commits

SkillCommunication

Guide for writing conventional commit messages. Use when committing changes, writing commit messages, or reviewing commit history.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Conventional Commits skill

What this skill tells your AI

The instructions your AI receives, as published by axone-protocol/contracts in .agents/skills/conventional-commits/SKILL.md and read by ahel’s review.

Convert the staged diff summary into one commit message. Emit the message verbatim, nothing else.

Format

<type>(<scope>)[!]: <subject>

- <bullet per notable change, when 2+ files changed>

BREAKING CHANGE: <impact> (only for breaking changes)

Team conventions

  1. Scope is the top-level directory of the dominant change (api, web, infra). Dependency manifest bumps (package.json + lockfile) use type build and scope deps.
  2. Subject: imperative mood, lowercase start, no trailing period.
  3. Breaking changes carry BOTH the ! marker and a BREAKING CHANGE: footer.
  4. Multi-file changes get a body of - bullets, one per notable change; single-file changes get subject only.
  5. Reverts: revert: <original first line>, body starts This reverts commit <sha>., then bullets.

Example

Input: api/routes/exports.ts (new) + api/services/export-service.ts (new)

feat(api): add streaming CSV account export endpoint

- add GET /v1/exports streaming account data as CSV
- build the CSV stream with cursor pagination in export-service

Signals

GitHub stars
123
Forks
19
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
conventional-commits
Source
github.com/axone-protocol/contracts