Release Notes

Create release notes for a new version tag. Gathers all commits, PRs, issues fixed, and breaking changes since a previous release. Creates the release notes markdown file, tags the repo, and pushes. Asks the user to confirm the base version to diff against.

1,052 stars 263 forksProductivity & Notes

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add agentic-community/mcp-gateway-registry --skill release-notes
Manual install
git clone --depth 1 https://github.com/agentic-community/mcp-gateway-registry.git /tmp/mcp-gateway-registry
mkdir -p ~/.claude/skills
cp -r /tmp/mcp-gateway-registry/.claude/skills/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 Skill

Use this skill when the user wants to create release notes for a new version. This skill gathers all changes since a previous release, writes structured release notes following the project's established format, tags the repo, and pushes.

## Input

The skill takes a version tag as input:
- Format: `{major}.{minor}.{patch}` (e.g., `1.24.0`) - **no `v` prefix**, semver only
- Older releases (pre-`1.23.0`) used a `v` prefix (e.g., `v1.0.22`) - existing artifacts under `docs/release-notes/v*.md` and tags `v1.0.x` are preserved as-is, but **new releases must use the bare-semver convention**
- If the user provides a `v`-prefixed version for a new release, strip the prefix and confirm

## Output

Creates a release notes file in `docs/release-notes/` and tags the repo:
- `docs/release-notes/{version}.md` - Release notes markdown file (e.g., `docs/release-notes/1.24.0.md`)
- Git tag `{version}` pointing to the commit that includes the release notes

## Workflow

### Step 0: Confirm the Pre-Release Smoke Test Was Run (Gate)

Before doing any release-notes work, confirm the end-to-end release smoke test
([tests/e2e_release_test.py](../../../tests/e2e_release_test.py)) has been run
against a live gateway and passed. This suite exercises the surface a release
must not break: the registry is up, the built-in `airegistry-tools` server is
healthy and its search tool works, servers/agents/skills support full CRUD,
Read the full skill on GitHub

Details

Skill name
release-notes
Path
.claude/skills/release-notes/SKILL.md
License
Apache-2.0
Repo updated
18 November 2026

FAQ

What does the Release Notes skill do?

Create release notes for a new version tag. Gathers all commits, PRs, issues fixed, and breaking changes since a previous release. Creates the release notes markdown file, tags the repo, and pushes. Asks the user to confirm the base version to diff against.

How do I install the Release Notes skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add agentic-community/mcp-gateway-registry --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 agentic-community/mcp-gateway-registry, which has 1,052 GitHub stars and 263 forks.

Related skills

Agentcore Register

1.1k

agentic-community/mcp-gateway-registry

Given an MCP server URL, probe the server via curl to discover its metadata and tools, then generate a markdown file with copy-pasteable content for each field in the Amazon Bedrock AgentCore "Create record" form.

AI, LLMs & Agents263

Benchmark Report

1.1k

agentic-community/mcp-gateway-registry

Generate a benchmark report from stress test results (registration, API performance, search concurrency). Reads JSON result files and produces a markdown report suitable for docs/benchmarks/.

Testing & QA263

Create Milestone

1.1k

agentic-community/mcp-gateway-registry

Create a GitHub milestone for an upcoming release. Suggests the next version based on the latest release, gathers all merged PRs and closed issues since that release, presents a draft with two tables (Issues and PRs) for user approval, then creates the milestone and assigns all approved items.

Git & Code Review263

Cicd Automation Workflow Automate

2k

rmyndharis/antigravity-skills

Design efficient CI/CD pipelines, GitHub Actions workflows, and automated development processes that reduce manual work and accelerate delivery while maintaining quality and security. Use when creating or improving build, test, and deployment automation.

Productivity & Notes295

Strategic Compact

2k

xu-xiang/everything-claude-code-zh

Suggests manual context compaction at logical intervals to preserve context through task phases rather than arbitrary auto-compaction.

Productivity & Notes332

Monorepo Architect

2k

rmyndharis/antigravity-skills

Design monorepo structure, build systems, and dependency boundaries using Nx, Turborepo, Bazel, or Lerna. Use when setting up a monorepo, optimizing builds, or scaling development workflows.

Productivity & Notes295

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