Release Notes

Draft evidence-backed release notes and changelog entries. Use this skill when PR notes, GitHub releases, or npm handoff need traceability.

9 stars 4 forksProductivity & Notes

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add jscraik/Agent-Skills --skill release-notes
Manual install
git clone --depth 1 https://github.com/jscraik/Agent-Skills.git /tmp/Agent-Skills
mkdir -p ~/.claude/skills
cp -r /tmp/Agent-Skills/Skills/content-publishing/release-notes ~/.claude/skills/release-notes

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Release Notes

## Philosophy
Release notes are a public evidence contract: concise, traceable, and honest about what changed.

## When To Use
- A PR, changelog, GitHub release, or npm handoff needs release communication.
- The user asks what changed between commits, tags, PRs, or Linear-linked work.
- `npm-release` needs a `release-notes-handoff.v1` before publish.

## Avoid
- Do not publish packages, mutate tags, or manage OTP.
- Do not invent shipped behavior when evidence is thin.
- Do not expose confidential Linear details in public text.

## Inputs
- User request and target repo or artifact.
- Evidence source such as files, diffs, issues, releases, or existing workflow state.
- Any safety, privacy, compliance, or approval constraints.

## Outputs
- Schema-bound outputs include `schema_version`.
- Release notes, changelog entry, or no-notes decision.
- Evidence list.
- `release-notes-handoff.v1` when feeding npm release.

## Workflow
1. Classify mode: PR notes, changelog update, release-history lookup, or npm handoff.
2. Collect evidence from git, PRs, Linear issues when available, changelog files, and release tags.
3. Separate user-facing changes, fixes, breaking changes, operational notes, and internal-only work.
4. Draft the smallest useful notes with evidence for each claim.
5. For npm, emit `release-notes-handoff.v1` with package, version, channel, sections, evidence, and blockers.
6. Stop before publish when blockers or channel mismatches exist.

## Constraints
Read the full skill on GitHub

Details

Skill name
release-notes
Path
Skills/content-publishing/release-notes/SKILL.md
License
Apache-2.0
Repo updated
16 November 2026

FAQ

What does the Release Notes skill do?

Draft evidence-backed release notes and changelog entries. Use this skill when PR notes, GitHub releases, or npm handoff need traceability.

How do I install the Release Notes skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add jscraik/Agent-Skills --skill release-notes. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Release Notes popular?

It lives in jscraik/Agent-Skills, which has 9 GitHub stars and 4 forks.

Related skills

Browse the most popular Claude skills, all productivity & notes skills, or write your own with the skills generator.