release-plugin

Automate packaging of source files into per-plugin release directories using release-mapping.yaml.

41|6|Updated Jul 12, 2025
One-click install
npx skills add https://github.com/SteveGJones/ai-first-sdlc-practices --skill release-plugin-stevegjones
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release-plugin
Source: https://github.com/SteveGJones/ai-first-sdlc-practices/tree/main/plugins/sdlc-core/skills/release-plugin
Command: npx skills add https://github.com/SteveGJones/ai-first-sdlc-practices --skill release-plugin-stevegjones

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates packaging of source files into per-plugin directories to prepare plugin releases, ensuring consistent structure and versioning across plugins.

Core Features & Use Cases

  • Read and apply release-mapping.yaml from the repo root to determine the target plugin packaging mappings.
  • Copy the relevant skill directories and supporting files into plugins/<plugin>/ directories, preserving structure and ensuring all components required for release are present.
  • Bump plugin versions in .claude-plugin/plugin.json (and marketplace.json) according to patch, minor, or major increments.
  • Validate the results by verifying source mappings exist and destinations are created, and report a packaged release summary.

Quick Start

Run release-plugin with a target release type to package source files according to release-mapping.yaml.

Frequently Asked Questions about release-plugin

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

FAQPage Schema
How do I automate plugin release packaging from source files?

Automate plugin release packaging by reading release-mapping.yaml to copy mapped skill directories into per-plugin release folders. This process preserves the required structure and copies supporting files to ensure all components are present for a consistent release.

How does version bumping work for plugin releases?

Version bumping updates the version field in .claude-plugin/plugin.json and marketplace metadata according to patch, minor, or major increments. This ensures your plugin release metadata accurately reflects the scope of changes during the automated packaging process.

What is release-mapping.yaml used for in plugin release workflows?

Release-mapping.yaml defines the target plugin packaging mappings located at the repository root. It dictates which skill directories and supporting files are copied into specific plugins/<plugin>/ directories to structure the release correctly.

How do I validate plugin release integrity after packaging source files?

Validate plugin release integrity by verifying that source mappings exist and destination directories are successfully created. The automated packaging process concludes by checking these conditions and reporting a packaged release summary.

Can I use automated plugin packaging without configuring a release mapping file?

No, automated plugin packaging requires a release-mapping.yaml file at the repository root. Without this mapping configuration, the process cannot determine which source files to copy or where to structure the per-plugin release directories.

What is the best way to manage multiple plugin releases in a single repository?

Manage multiple plugin releases by using an automated workflow that reads a central mapping file to package source files into individual plugin directories. This approach applies version bumps and validates each destination separately to ensure release consistency.