Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add dominikmartn/harp --skill changelog-draft -a claude-code
Open on GitHub

What 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_01 on the stable channel
  • Generate the changelog with all attribution
  • Run fetch_prs.py and 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-code

2Manually: put the files in place

~/.claude/skills/changelog-draft/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/changelog-draft/

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.

Similar skills

All skills for Git and GitHub →

From the same set62

The whole set →
cross-platform-cloud-verification The cross-platform-cloud-verification skill for Claude Code manages cost-effective cloud testing across multiple operating systems and architectures. It runs for changes with cross-platform impacts. CX Codex +1 ★ 720repo stars review-pr-local review-pr-local is a Claude Code skill that applies Warp repository rules to pull request reviews. It extends the core review-pr skill. CX Codex +1 ★ 720repo stars warpctrl warpctrl is a Claude Code skill that hands the agent a CLI into the Warp app already open on the machine: tabs, panes, the input buffer, themes, settings. Requests about Warp's own windows land here instead of the project tree. CX Codex +1 ★ 720repo stars gui-create-launch-modal gui-create-launch-modal is a Claude Code skill for building a one-time launch modal in Warp’s GUI. A feature flag controls the startup display for each user. CX Codex +1 ★ 720repo stars oz-platform oz-platform is a Claude Code skill for running and inspecting Oz cloud agents through Warp's REST API and CLI. It also handles schedules and agent environments. CX Codex +1 ★ 720repo stars rust-unit-tests rust-unit-tests is a Claude Code skill that writes and improves Rust unit tests within the codebase. It assists when handling data transformations or fixing reproducible bugs. CX Codex +1 ★ 720repo stars gui-settings-ui gui-settings-ui is a Claude Code skill for editing Warp GUI settings pages. It keeps widget visibility and settings search aligned with the page structure. CX Codex +1 ★ 720repo stars gui-integration-test gui-integration-test is a Claude Code skill that writes and debugs integration tests for Warp's GUI desktop app on the Builder/TestStep harness. Runs when a test is added or fixed. CX Codex +1 ★ 720repo stars

Project sponsors

Companies that keep this analytics open