Skill

Conventional Commit

gitcommitsconventional commits

Save the file as ~/.claude/skills/conventional-commit/SKILL.md (user-level, available everywhere) or .claude/skills/conventional-commit/SKILL.md (project-level). Claude Code loads it automatically when its trigger condition matches.

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.

Full Prompt
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.