changelog
Changelog (maintainer-only)
Keep CHANGELOG.md honest with package.json. The dependency is the version bump: the moment
package.json's version changes, the new version needs a matching section at the top of
CHANGELOG.md, with one concise bullet per consumer-facing change (AGENTS.base.md, a skill under
skills/, bin/sync.mjs, templates/). The changelog is considered stale until that section exists.
A PostToolUse hook (
.claude/hooks/changelog-check.mjs, wired in.claude/settings.json) enforces this automatically: after any edit, ifpackage.json's version has noCHANGELOG.mdsection yet, it injects a reminder pointing back here. So in practice this skill fires as soon as you bump the version — you don't have to remember to invoke it.
This skill is local to this repo and must stay that way. It lives in
.claude/skills/, not inskills/, sobin/sync.mjsnever fans it out to Claude/Cursor/AGENTS.md,package.json'sfilesnever publishes it, and no consumer of the package ever sees it. Do not move it intoskills/and do not add it to the## Skillsindex — that would expose a maintainer tool to every downstream repo.