Commit Discipline

Commit messages that match the diff, not just the format — measured, not assumed.

Tested · Works

Test report

Verdict
Tested · Works
Score
8.8/10
Tested
Jul 11, 2026
Environment
Claude Code 2.x (agent harness)
Upstream re-checked
Aug 10, 2026 · 940967b

Our own skill — tested under the same protocol, disclosed. Bench ran 15 real diffs from curl/redis/express/fastapi/eslint/django/rust-analyzer/astro through baseline vs. skill agents: diff coverage rose 83.2%→96.7%, fabrications fell 1→0, split detection on planted multi-concern diffs went 0/2→2/2, and blind A/B preference favored the skill 9-4-2. Judging was in-model-family (self-preference risk, n=15, not statistically significant) and the base arm still won 3 fixtures outright on tightly-scoped diffs — both caveats are stated plainly in the skill's own verdict.md and README. Protocol test caught real issues in our own repos (dead benchmark links, strict-YAML frontmatter) — fixed and re-verified same day.

Scored on four weighted criteria — install, triggering, output vs. baseline, docs. How scoring works

  • Installs cleanly 5/5
  • Triggers reliably 5/5
  • Output vs. baseline 7/10
  • Docs & honesty 5/5

What Commit Discipline does

Enforces that a commit message covers the full staged diff, invents nothing, and explains why instead of restating what — on top of standard Conventional Commits formatting. Reads the full `git diff --cached` before writing, recommends splitting multi-concern diffs, bans vague verbs like "update"/"fix stuff", and requires BREAKING CHANGE footers to be earned from the diff rather than left to memory.

Commit Discipline before / after — same task, with and without

Without the skill

update deps

With Commit Discipline

bump axios 1.6→1.7 Patches CVE-2026-xxxx in the redirect handler; no API changes for callers of this package.

How to install Commit Discipline

git clone https://github.com/Skillproofdev/commit-discipline ~/.claude/skills/commit-discipline

Skills live in ~/.claude/skills/ (global) or .claude/skills/ (per-project). Restart Claude Code after installing.

Commands — how to trigger Commit Discipline

  • /commit-discipline Commit messages that match the diff, not just the format — measured, not assumed.

It also activates on plain-language prompts like these:

  • Commit this
  • Write a commit message for my staged changes
  • Can you review this commit message: 'fix stuff'

Frequently asked questions

Is the Commit Discipline skill free?
Yes. The skill itself is free from Skillproofdev/commit-discipline. SkillProof publishes the install command and an independent test verdict at no cost.
Does Commit Discipline work with Claude Code?
We tested it with Claude Code 2.x (agent harness) on Jul 11, 2026. Verdict: Tested · Works. Our own skill — tested under the same protocol, disclosed. Bench ran 15 real diffs from curl/redis/express/fastapi/eslint/django/rust-analyzer/astro through baseline vs. skill agents: diff coverage rose 83.2%→96.7%, fabrications fell 1→0, split detection on planted multi-concern diffs went 0/2→2/2, and blind A/B preference favored the skill 9-4-2. Judging was in-model-family (self-preference risk, n=15, not statistically significant) and the base arm still won 3 fixtures outright on tightly-scoped diffs — both caveats are stated plainly in the skill's own verdict.md and README. Protocol test caught real issues in our own repos (dead benchmark links, strict-YAML frontmatter) — fixed and re-verified same day.
What is the Commit Discipline SkillProof Score?
8.8/10 — installs cleanly 5/5, triggers reliably 5/5, output vs. baseline 7/10, docs & honesty 5/5.
How do I install Commit Discipline?
Copy the install command from this page, run it in your terminal, and restart Claude Code. Skills live in ~/.claude/skills/ (global) or .claude/skills/ inside a project.
Can I use Commit Discipline with Cursor, Copilot, Gemini CLI, Codex or other AI tools?
The SKILL.md format is native to Claude (Claude Code, Desktop, claude.ai). The instructions inside adapt to other assistants: Cursor rules, GitHub Copilot instructions, Windsurf rules, Custom GPTs, AGENTS.md for OpenAI Codex, and GEMINI.md for Google Gemini CLI — our conversion guides cover each, and the free converter on the tools page does the wrapping for you.