Does this require the GitHub CLI?

Yes, this skill utilizes the official GitHub CLI (gh) to view PR data and update release notes via the command line.

Can I use this on the release PR before merging?

No. Modifying the PR body breaks the release-please parser. This skill is strictly designed to run after the PR is merged and the release is officially created.

Does it delete my original technical changelog?

No, it preserves the original content by moving it into a collapsible block, ensuring full traceability remains available while prioritizing the summary.

Why does it need to fetch full PR bodies?

Commit titles and PR names are often too brief for users. Fetching the full description allows the AI to understand the actual impact and write a better summary.

Which technical terms does it avoid?

The skill is programmed to omit jargon like 'refactor', 'virtualization', 'SSR', and 'CI' in the main summary to ensure the notes are accessible to users and PMs.

Release-Please Description Updater

Name: Release-Please Description Updater
Author: fx

byfx

•

Deployment & DevOps

Transforms technical release-please logs into polished, human-readable GitHub Release summaries using pull request context.

This skill automates the creation of high-quality GitHub Release descriptions by analyzing pull request bodies rather than relying solely on commit titles. It bridges the gap between automated release tools and stakeholder communication by generating non-technical summaries for end-users and project managers while preserving the technical changelog in a collapsible section. Most importantly, it follows a safety-first workflow that prevents breaking the internal parsing logic of release-please, ensuring your versioning automation remains stable.

Key Features

01Automatically categorizes changes into user-facing features and improvements

021 GitHub stars

03Translates technical jargon into plain-language updates for non-developers

04Extracts context from full PR descriptions to write meaningful summaries

05Preserves the full technical changelog in a clean, collapsible details section

06Prevents breaking release-please by only modifying finalized GitHub Releases

Use Cases

01Generating stakeholder-ready updates after merging a release-please PR

02Cleaning up changelogs by filtering out internal refactors and CI updates

03Polishing automated release notes for public open-source projects

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add fx/cc update-description

For use in Claude.ai and ChatGPT

Download Skill