update-changelog

Write changelog entries for commits since the last release, matching the project's existing format.

Activate only on /update-changelog or explicit request. Follow steps EXACTLY.

Workflow Checklist

- [ ] 0. Config check
- [ ] 1. Detect latest tag
- [ ] 2. Collect commits
- [ ] 3. Read existing changelog
- [ ] 4. Filter and categorize (silent)
- [ ] 5. Present and confirm
- [ ] 6. Write changelog

---

SKILL_BASE_DIR: ${CLAUDE_SKILL_DIR}

⛔ If SKILL_BASE_DIR shows literal ${CLAUDE_SKILL_DIR}, halt: "This skill requires Claude Code 2.1.69 or higher."

Silence: Narrate only STEP_DESCRIPTION steps; execute all others silently. Format fidelity: Detect and match the existing changelog's format. Never impose a new one.

---

Step 0 — Config Check

Run: node "${CLAUDE_SKILL_DIR}/../../lib/check-skill-config.js" "./.claude/settings.plugins.update-changelog.json"

• Found → cat .claude/settings.plugins.update-changelog.json, extract changelogPath as CHANGELOG_PATH. Verify with git ls-files --error-unmatch "{{CHANGELOG_PATH}}" 2>/dev/null || test -f "{{CHANGELOG_PATH}}". If missing, ask for correct path (default: ./CHANGELOG.md) and update config.
• NOT_CONFIGURED → say config is missing. Ask: "Where is your changelog file? (default: ./CHANGELOG.md)" Store as CHANGELOG_PATH. Write: echo '{"changelogPath":"{{CHANGELOG_PATH}}"}' > .claude/settings.plugins.update-changelog.json

Step 1 — Detect Latest Tag

STEP_DESCRIPTION: "Detecting latest release tag"

Run: git tag --list --sort=-v:refname

Find the most recent semver-like tag (v1.2.3, 1.2.3, release-1.2.3, or any digits-and-dots pattern). Store as LATEST_TAG; strip prefix for LATEST_VERSION.

No semver tag → say so and HALT.

Step 2 — Collect Commits

STEP_DESCRIPTION: "Collecting commits since last release"

Run: git log {{LATEST_TAG}}..HEAD --pretty=format:"%h|%s|%b---END---"

Empty output → say "No changes since {{LATEST_TAG}}." and HALT.