Free changelog linter — grade your CHANGELOG.md (plus a badge for your README)new
Aug 7, 2026 · by dario
We read a lot of changelogs while writing our guides, and the same problems kept showing up: commit dumps, undated entries, "misc fixes", breaking changes buried under "Improved". So we turned the guides into a tool.
The changelog linter takes a pasted CHANGELOG.md or a GitHub repo URL (it reads Releases too) and returns a graded report — 12 checks, a 0–100 score, and every finding links the guide that explains the fix.
Two things come with it:
- A grade badge for your README. Shields-style SVG at
/lint/badge.svg?url=<your repo>, linking back to the full report. Cached server-side, so README traffic never hammers anyone's API. - The report-card gallery — 30 popular open-source projects (curl, ripgrep, Hugo, Laravel, GitHub CLI…) graded by the same linter, re-checked automatically. See how your favorite tools score.
No signup needed for any of it. If the linter finds things to fix, the guides are right there — and if you'd rather have a changelog that's hard to get wrong, well, you know where the signup button is.