Is the Changelog Discipline skill free?

Yes. The skill itself is free from Skillproofdev/changelog-discipline. SkillProof publishes the install command and an independent test verdict at no cost.

What is the Changelog Discipline SkillProof Score?

8.0/10 — installs cleanly 5/5, triggers reliably 4/5, output vs. baseline 6/10, docs & honesty 5/5.

How do I install Changelog 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 Changelog 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.

Changelog Discipline

Changelogs that trace to real commits — breaking changes never buried or dropped

by SkillProof · Skillproofdev/changelog-discipline

Tested · Works

Install — copy the command Download source ↗

Test report

Verdict: Tested · Works
Score: 8.0/10
Tested: Jul 11, 2026
Environment: Claude Code 2.x (agent harness)
Upstream re-checked: Aug 10, 2026 · 4c1e989

Our own skill — tested under the same protocol, disclosed. Benchmarked head-to-head against a no-skill baseline across 4 real OSS release ranges (Django, Tailwind CSS, FastAPI, curl): fabrication tied 0-0 for both arms (neither invented entries, versions, dates, or citations), but the skill decisively won Keep-a-Changelog format compliance (30/36 vs 13/36) and breaking-change-first placement (4/4 ranges vs 0/4) plus large traceable-commit-coverage gains (e.g. Django 58% vs 6%, Tailwind 87% vs 0%). Base won blind readability preference on the two largest/noisiest repos (curl, Django) and edged the skill on FastAPI's traceable coverage by citing internal commits the skill correctly excluded — a genuinely mixed result, published in full including the losses. 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 4/5
Output vs. baseline 6/10
Docs & honesty 5/5

What Changelog Discipline does

Enforces honesty discipline on changelog generation: every entry must trace to a real commit or PR, breaking changes are actively hunted and placed first, and nothing is invented or padded. Outputs strict Keep-a-Changelog formatting instead of the loosely-structured prose agents default to unprompted. Benchmarked against a no-skill baseline on four real OSS repos, with both the wins and the losses published in full.

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

Without the skill

## New in 6.0 ### Features - Composite primary key support - Automatic model imports for the shell ### Deprecated features - ADMINS/MANAGERS as tuples ### Notes on scope See the full release notes for further detail on database backend changes.

With Changelog Discipline

## [6.0] - 2025-11-05 ### Removed - **BREAKING**: Dropped support for Python 3.10; upgrade to Python 3.11+ before updating (abc1234) ### Deprecated - **BREAKING**: `ADMINS`/`MANAGERS` as tuples is deprecated; use a list instead (#9142) ### Added - Composite primary key support (#9021) - Automatic model imports in the interactive shell (#8994)

How to install Changelog Discipline

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

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

Commands — how to trigger Changelog Discipline

/changelog-discipline Changelogs that trace to real commits — breaking changes never buried or dropped

It also activates on plain-language prompts like these:

Write release notes for v2.3.0 based on the commits since v2.2.0
Update CHANGELOG.md with everything that changed since the last release
What changed between the v1.4 and v2.0 tags? I need to draft a release announcement from the commit history

Frequently asked questions

Is the Changelog Discipline skill free?: Yes. The skill itself is free from Skillproofdev/changelog-discipline. SkillProof publishes the install command and an independent test verdict at no cost.
Does Changelog 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. Benchmarked head-to-head against a no-skill baseline across 4 real OSS release ranges (Django, Tailwind CSS, FastAPI, curl): fabrication tied 0-0 for both arms (neither invented entries, versions, dates, or citations), but the skill decisively won Keep-a-Changelog format compliance (30/36 vs 13/36) and breaking-change-first placement (4/4 ranges vs 0/4) plus large traceable-commit-coverage gains (e.g. Django 58% vs 6%, Tailwind 87% vs 0%). Base won blind readability preference on the two largest/noisiest repos (curl, Django) and edged the skill on FastAPI's traceable coverage by citing internal commits the skill correctly excluded — a genuinely mixed result, published in full including the losses. Protocol test caught real issues in our own repos (dead benchmark links, strict-YAML frontmatter) — fixed and re-verified same day.
What is the Changelog Discipline SkillProof Score?: 8.0/10 — installs cleanly 5/5, triggers reliably 4/5, output vs. baseline 6/10, docs & honesty 5/5.
How do I install Changelog 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 Changelog 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.