A Claude Code skill that maintains a CHANGELOG.md inside any skill directory being created or edited.
Whenever a skill's SKILL.md (or any file in a skill directory) is modified, skill-changelog appends a dated, versioned entry to that skill's CHANGELOG.md. It follows Keep a Changelog formatting and auto-infers the semver bump from the scope of the change.
The skill runs in one of two modes, stored in ~/.claude/skills/.skill-changelog/mode:
| Mode | Behavior |
|---|---|
opt-in (default) |
Only writes to CHANGELOG.md if it already exists, or the user explicitly initializes it |
auto |
Always writes — creates CHANGELOG.md if absent, then appends an entry |
Switch modes by telling Claude: "switch to auto" or "switch to opt-in".
Copy or symlink the skill-changelog/ directory into your skills folder:
~/.claude/skills/skill-changelog/
The skill triggers automatically during any skill editing workflow. You can also invoke it directly:
/skill-changelog
To initialize a changelog on a skill that doesn't have one yet, open that skill and run /skill-changelog — it will create CHANGELOG.md with the proper header and a first entry.
skill-changelog/
└── SKILL.md ← skill definition and instructions