changelog-draft — Claude Code skill: changelog draft from merged PRs
changelog-draft is a Claude Code skill that turns pull requests merged between two release tags into a changelog draft, keeping explicit CHANGELOG markers and sorting the rest into categories.
AGPL-3.0 ★ 720 updated 2026-11-10
npx skills add dominikmartn/harp --skill changelog-draft -a claude-codeWhat changelog-draft does
The skill builds a changelog draft for one release tag out of the pull requests that landed since the previous release cut. It takes a channel (stable, preview or dev) and a release_tag; files go to $RUNNER_TEMP or /tmp/changelog-draft unless another directory is passed, and attribution runs in external-only, all or none mode.
Picking the base tag is a step of its own. Tags look like v0.YYYY.MM.DD.HH.MM.<channel>_NN, and the comparison point is the _00 tag of the earlier date, so v0.2026.04.29.08.57.stable_01 is measured against v0.2026.04.22.08.57.stable_00. Four python scripts then do the work: fetch_prs.py collects PRs and their explicit markers, classify_contributors.py splits authors into internal, external and bot, extract_feature_flags.py reads flag lists out of crates/warp_features/src/lib.rs, and fetch_issue_reporters.py credits outside reporters of linked issues.
Output is markdown plus JSON. channel_versions.json stays untouched. A run inside warpdotdev/warp-internal only lets through PRs mirrored by warp-repo-sync[bot], and internal_pr data stays audit-only — it never becomes a contributor credit or a changelog link. Needs python3 and GitHub API access for the org membership checks.
What it helps with
- draft a changelog for PRs merged between two release tags
- pull explicit CHANGELOG markers out of PR bodies
- sort unmarked PRs into feature, improvement and bug fix
- separate outside contributors from staff and bots
- emit markdown and JSON without touching
channel_versions.json
Example prompts for the agent
- Draft the changelog for
v0.2026.04.29.08.57.stable_01on thestablechannel - Generate the changelog with
allattribution - Run
fetch_prs.pyand list the PRs that came back without CHANGELOG markers
How to install changelog-draft
1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill changelog-draft -a claude-code2Manually: put the files in place
~/.claude/skills/changelog-draft/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/changelog-draft/
1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill changelog-draft -a codex2Manually: put the files in place
.agents/skills/changelog-draft/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill changelog-draft -a cursor2Manually: put the files in place
.cursor/skills/changelog-draft/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install dominikmartn/harp .agents/skills/changelog-draft2Manually: put the files in place
.github/skills/changelog-draft/SKILL.md1Skills CLI (Vercel)
npx skills add dominikmartn/harp --skill changelog-draft -a gemini-cli2Platform CLI
gemini skills install https://github.com/dominikmartn/harp --path .agents/skills/changelog-draftManually: put the files in place
.devin/skills/changelog-draft/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about changelog-draft
How do I install changelog-draft in Claude Code?
Run npx skills add dominikmartn/harp --skill changelog-draft -a claude-code. The skill lands at ~/.claude/skills/changelog-draft/SKILL.md.
What does changelog-draft do?
It turns PRs merged in a release range into a changelog draft and writes markdown plus JSON. Explicit CHANGELOG markers are kept and the remaining PRs get a category.
What does changelog-draft need to run?
python3, a repository with release tags, and GitHub API access for the org membership lookups.