changelog-draft

Generate changelog drafts from merged PRs with markdown and JSON outputs.

6|Updated May 10, 2026
One-click install
npx skills add https://github.com/Luohao-Yan/warp-cn --skill changelog-draft-luohao-yan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: changelog-draft
Source: https://github.com/Luohao-Yan/warp-cn/tree/main/.agents/skills/changelog-draft
Command: npx skills add https://github.com/Luohao-Yan/warp-cn --skill changelog-draft-luohao-yan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python, git, github-api, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the creation of a reviewable changelog draft from PRs merged within a specified release range, saving time and reducing manual errors.

Core Features & Use Cases

  • Changelog Draft Generation: Extracts explicit changelog markers from PRs, classifies unmarked PRs, adds external contributor attribution, and outputs markdown and JSON artifacts.
  • Release Range: Supports specifying a release range by providing the base and head tags.
  • Output Files: Generates changelog-draft.md and changelog-draft.json files for human review and machine audit, respectively.
  • Use Case: Ideal for open-source project maintainers looking to streamline the process of generating changelogs for new releases.

Quick Start

Use the changelog-draft skill to generate a changelog draft for the release range between 'v0.2026.04.29.08.56.stable_00' and 'v0.2026.05.06.09.12.stable_00'.

Frequently Asked Questions about changelog-draft

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate changelog generation from merged PRs for a new release?

Automating changelog generation from merged PRs involves extracting explicit markers, classifying unmarked entries, and attributing contributors. This Skill generates reviewable markdown and machine-readable JSON artifacts based on a specified release tag range.

How do I specify the release range for extracting PR data?

You specify the release range by providing the base and head Git tags. The Skill fetches PR data within this boundary from the GitHub API to compile the changelog draft.

Do I need Python and Git installed to generate a changelog draft?

Yes, generating a changelog draft requires Python, Git, and GitHub API access. These dependencies are necessary to fetch PR data, parse repository history, and output the final artifacts.

What is the best way to handle unmarked PRs in release management?

Handling unmarked PRs in release management is automated here by classifying them based on their content. The Skill integrates these classified entries into the final markdown and JSON changelog artifacts.

Does this changelog generator output machine-readable files for CI pipelines?

Yes, this changelog generator outputs a `changelog-draft.json` file specifically designed for machine audit and CI pipelines, alongside a `changelog-draft.md` file for human review.