From workflow-skills
Consolidate per-branch changelog files into CLAUDE.md, then clean up worktrees and merged branches.
How this skill is triggered — by the user, by Claude, or both
Slash command
/workflow-skills:consolidate-changelogsThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Merges pending `docs/changelogs/*.md` files into CLAUDE.md and cleans up stale git worktrees and merged branches.
Merges pending docs/changelogs/*.md files into CLAUDE.md and cleans up stale git worktrees and merged branches.
Run this after a batch of branches have been merged to master — typically when multiple changelog files have accumulated in docs/changelogs/.
Read every .md file in docs/changelogs/ (skip .gitkeep). For each file, extract:
## Change Log section.If there are no changelog files, stop and tell the user there's nothing to consolidate.
For each changelog's ## CLAUDE.md updates section, apply the requested changes to the relevant parts of CLAUDE.md:
Be precise — match the existing style and formatting of each section.
Add each branch's changes as a one-line bullet in the ### Earlier changes list. Format:
- **Short title** (`branch-name`): One-sentence summary of what changed. Key migration or file if notable.
If a previous full entry (with "What changed" and "Technical details" subsections) exists for a branch that's now being consolidated, replace it with a condensed one-liner in the ### Earlier changes list.
Update the date range in the ### Earlier changes header if needed.
Remove all .md files from docs/changelogs/ that were just consolidated. Preserve .gitkeep. If .gitkeep was accidentally deleted, recreate it with touch.
git worktree list
For each worktree that corresponds to a merged branch:
git worktree remove <path> — use --force only if the worktree contains just build artifacts (e.g., tsconfig.app.tsbuildinfo, node_modules, __pycache__). If it has real modified files, warn the user.git worktree prune to clean stale references..worktrees/ (e.g., .worktrees/feat/, .worktrees/fix/).List local branches (git branch) and delete ones that have been merged to master:
git branch -d <branch-name>
If -d fails (not merged), do NOT force delete — warn the user instead.
docs/changelogs/ contains only .gitkeepgit worktree list shows only the main worktreegit branch shows only master (or expected long-lived branches)git branch -d fails, the branch isn't fully merged — ask the user.npx claudepluginhub donotdonuts/claude-workflow-skills --plugin workflow-skillsGenerates or updates CHANGELOG.md from git history in Keep-a-Changelog format using parallel haiku subagents per version range.
Implements two-phase workflow to analyze code changes via git diff and update project documentation. Use before merging branches, after features/bugfixes, or when docs stale.
Updates CLAUDE.md files with non-obvious conventions and gotchas from staged git changes. Activates on user requests like 'update CLAUDE.md' or significant code modifications.