release

Generate changelogs, bump versions, and tag releases for Wicked Garden plugins.

8|2|Updated Feb 9, 2026
One-click install
npx skills add https://github.com/mikeparcewski/wicked-garden --skill release-mikeparcewski
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release
Source: https://github.com/mikeparcewski/wicked-garden/tree/main/.claude/skills/releasing
Command: npx skills add https://github.com/mikeparcewski/wicked-garden --skill release-mikeparcewski

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Release management for Wicked Garden plugins is complex and error-prone. This Skill automates changelog generation, semantic versioning, and version bumps from git history, coordinating updates across plugin.json and marketplace.json to ensure releases are consistent and traceable.

Core Features & Use Cases

  • Automated changelog generation from commit messages into a structured format.
  • Deterministic semantic version bumping (major/minor/patch) aligned with commit history.
  • Automatic updates to plugin.json and marketplace.json, tag creation, and optional release notes publishing.
  • Flexible workflows with dry-run support and JSON reporting for safe, auditable releases.

Quick Start

Run the release tool from the plugin root to analyze commits, determine the next version, update plugin.json and marketplace.json, generate CHANGELOG.md, tag the release, and optionally publish a GitHub release.

Frequently Asked Questions about release

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

FAQPage Schema
How do I automate changelog generation and version bumping from git commit history?

Automated changelog generation and version bumping from git history works by parsing commit messages to determine semantic version increments, then updating plugin.json and marketplace.json while creating structured release notes. This eliminates manual version tracking and reduces release errors.

What is the best way to keep plugin.json and marketplace.json versions consistent during a release?

Keeping plugin.json and marketplace.json versions consistent during a release requires coordinating updates across both files simultaneously. Automated release management reads git history, calculates the correct semantic version, and writes the same version number to both metadata files in a single operation.

Can I do a dry run of a semantic version release without modifying files or creating git tags?

Yes, you can perform a dry run of a semantic version release without modifying files or creating git tags. Dry-run mode analyzes commit history and reports the calculated version bump, changelog content, and planned file updates as JSON output, leaving your repository untouched.

How does deterministic semantic versioning decide between major, minor, and patch releases?

Deterministic semantic versioning decides between major, minor, and patch releases by applying predefined rules to your git commit history. Commit message patterns are evaluated to determine the level of change, ensuring the version bump accurately reflects whether breaking changes, features, or fixes were introduced.

Do I need a specific git workflow or commit message format for automated plugin release management?

Automated plugin release management relies on git commit history to generate changelogs and determine version bumps, so a consistent commit message format is necessary. The tool parses commit history to identify changes, meaning unstructured or inconsistent commit messages may result in less accurate changelog generation and versioning.

Why are my automated changelog entries missing or incorrectly categorized during a plugin release?

Automated changelog entries can be missing or incorrectly categorized during a plugin release when git commit messages lack the structured patterns needed for parsing. Because changelog generation reads directly from commit history, inconsistent formatting or vague commit descriptions directly impact the quality and accuracy of the generated release notes.