add-release-highlights

Drafts release highlights from a changelog and syncs them to GitHub Releases.

4.3k|859|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/ArcReel/ArcReel --skill add-release-highlights
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-release-highlights
Source: https://github.com/ArcReel/ArcReel/tree/main/.agents/skills/add-release-highlights
Command: npx skills add https://github.com/ArcReel/ArcReel --skill add-release-highlights

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writing consistent, user-facing release highlights for each version is repetitive and error-prone, especially when the same summary must stay identical across the Changelog and the GitHub Release page.

Core Features & Use Cases

  • Draft from Changelog: Reads the target version's full Changelog as the factual boundary, tracing related issues or commits only when entries are unclear, and condenses user-visible changes into a few outcome-oriented themes.
  • Approval-gated sync: Presents the draft for explicit user confirmation before touching anything, keeping the Changelog and GitHub Release read-only until approved.
  • Atomic publish: Inserts the confirmed block into the Changelog, mirrors it verbatim to the GitHub Release, commits with chore(changelog): add <version> highlights, and pushes to main.
  • Use Case: After tagging v1.4.0, ask the assistant to draft the release highlights; review the proposed themes, approve them, and have the Changelog, GitHub Release, and git push completed in one flow.

Quick Start

Use add-release-highlights to draft the highlights for version 1.4.0, wait for my approval, then sync them to the Changelog and GitHub Release and push to main.

Frequently Asked Questions about add-release-highlights

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

FAQPage Schema
How do I generate release highlights from a changelog?

Point the skill at the target version and it reads that version's full Changelog as the factual boundary, merging user-visible changes into a few outcome-oriented themes. It then presents the draft for your confirmation before making any edits.

How do I sync changelog entries to a GitHub Release?

After you approve the drafted highlights, the skill inserts the block into the Changelog between the version heading and its detail sections, then copies the identical text to that version's GitHub Release so both stay verbatim consistent.

Does the skill edit files before I approve the draft?

No. The drafting phase keeps the Changelog and GitHub Release strictly read-only and ends the turn after showing the draft. File edits, the commit, and the push only happen after you explicitly confirm the complete draft.

What commit and push behavior does the release workflow use?

It stages only the Changelog change, commits with the message `chore(changelog): add <version> highlights`, and runs `git push origin main`. The working tree must be on the main branch before execution begins.

What are the limitations of changelog-based release drafting?

The Changelog is the factual boundary, so changes missing from it will not appear in the highlights. Internal changes are only included when they produce user-perceivable results, and unclear entries require tracing related issues or commits.