release-plugin

Detect plugin changes, bump version, update plugin.json and CHANGELOG, and stage release commits.

8|1|Updated Apr 10, 2026
One-click install
npx skills add https://github.com/max4c/skills --skill release-plugin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release-plugin
Source: https://github.com/max4c/skills/tree/main/skills/release-plugin
Command: npx skills add https://github.com/max4c/skills --skill release-plugin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Ship plugin updates deterministically by detecting changes, bumping the version, updating the changelog and plugin.json, staging surgically, committing, and presenting UI commands to finalize the release.

Core Features & Use Cases

  • Detect plugin changes and compute the correct version bump (patch/minor/major) based on diffs.
  • Update repository metadata (plugin.json) and CHANGELOG, then stage and commit changes without disturbing ongoing work.
  • Provide exact Claude Code UI commands to finish the release, including push and merge handling for multi-branch repos.

Quick Start

Initiate a release by following the five-step workflow and review the generated Claude Code UI commands.

Frequently Asked Questions about release-plugin

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

FAQPage Schema
How do I automate version bumps and changelog updates for a Claude Code plugin release?

Automating a Claude Code plugin release involves detecting diffs to compute the correct version bump, updating plugin.json and CHANGELOG, and surgically staging changes. This minimizes disruption to ongoing work in multi-branch workflows.

What is the best way to stage plugin updates surgically in a multi-branch git workflow?

Staging plugin updates surgically requires isolating version bump and changelog modifications from unrelated work. This skill drafts a surgical git staging plan and outputs exact UI commands to finalize releases across multi-branch repositories.

How does a plugin release workflow determine whether to apply a patch, minor, or major version bump?

A plugin release workflow determines the version bump by analyzing git diffs. This skill detects code changes and computes the correct semantic version increment to apply to plugin.json automatically.

Do I need a .claude-plugin/plugin.json file to use an automated release workflow?

Yes, you need a .claude-plugin/plugin.json file. This skill applies specifically to repositories containing that metadata file to detect changes, bump versions, and finalize the plugin release via Claude Code UI commands.

Can I finalize a plugin update push and merge without disrupting ongoing development?

Yes, you can finalize a plugin update without disruption by using surgical git staging. This skill outputs the exact Claude Code UI commands to manage push and merge operations safely alongside ongoing work.