Conventional Commit Skill: One Message, No Negotiation
Conventional Commits work when everyone follows them. They stop working when half your commits start with "update stuff" because picking a type felt like too much thinking at midnight. This skill makes it a one-step: stage, ask, commit.
An installable skill that turns the staged diff into a Conventional Commits message ready to paste into git commit.
What It Does
- Reads
git diff --staged— works from what's actually about to land - Picks the dominant type — feat / fix / refactor / perf / test / docs / chore
- Writes under 72 chars — imperative, no period, no emoji
- Adds a body only when it earns it — motivation, breaking change, ticket reference
Install in 30 Seconds
Pick your tool above and hit Download:
- Claude Code:
~/.claude/skills/conventional-commit/SKILL.md - OpenAI Codex CLI: append to your project's
AGENTS.md - Cursor: append to
.cursorrules
Then stage your changes and ask for a commit message. The output is a single code block ready to paste.
Why It Matters
Good commit history is a thinking habit, not a tooling problem. But tooling can keep the habit cheap. With this skill installed, the marginal cost of a proper Conventional Commit message drops to zero — which is what it takes to never type "update stuff" again.
Install once, commit cleanly every time.