release

Bump project versions across pyproject.toml, plugin.json, and CHANGELOG.md.

10|Updated Dec 26, 2025
One-click install
npx skills add https://github.com/s-hiraoku/synapse-a2a --skill release-s-hiraoku
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release
Source: https://github.com/s-hiraoku/synapse-a2a/tree/main/.claude/skills/release
Command: npx skills add https://github.com/s-hiraoku/synapse-a2a --skill release-s-hiraoku

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the process of bumping project versions across core artifacts (pyproject.toml, plugin.json) and updating the CHANGELOG.md, ensuring consistent versioning and release documentation.

Core Features & Use Cases

  • Semantic versioning support: patch, minor, major, or a specific version.
  • Cross-file synchronization: updates pyproject.toml and plugin.json to the new version and appends a changelog entry.
  • Changelog automation: can analyze recent commits to generate a descriptive changelog when description is not provided, and records release notes for the next version.

Quick Start

Invoke /release with a version type (patch, minor, major) or a specific version to update pyproject.toml, plugin.json, and CHANGELOG.md.

Frequently Asked Questions about release

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

FAQPage Schema
How do I bump project versions in pyproject.toml and plugin.json at the same time?

To bump project versions across pyproject.toml and plugin.json simultaneously, invoke the release skill with a semantic version type (patch, minor, major) or a specific version. It reads current versions, calculates the new version, and applies changes to all files automatically.

Can I automatically generate changelog content from recent git commits?

Yes, you can automatically generate changelog content from recent git commits. When you omit the description parameter during version bumping, the skill analyzes recent commits to auto-generate a descriptive changelog entry and appends it to CHANGELOG.md.

What is the best way to update a changelog when releasing a new semantic version?

The best way to update a changelog when releasing a new semantic version is using automated cross-file synchronization. The skill updates pyproject.toml and plugin.json while appending a validated changelog entry, ensuring consistent versioning and release documentation.

Does the version bumping skill validate version progression across files?

Yes, the version bumping skill validates version progression across files. After reading current versions and calculating the new semantic version, it applies changes to pyproject.toml and plugin.json while validating the progression and producing a concise release summary.

How do I set a specific version number instead of using patch, minor, or major increments?

To set a specific version number instead of using patch, minor, or major increments, invoke the release skill with the exact version string. It bypasses semantic calculation, applies the specified version to pyproject.toml and plugin.json, and updates the changelog.