Does it support monorepo structures?

Yes, it is specifically designed for monorepos, using a plugin-prefixed tagging convention (e.g., plugin-v1.0.0) to prevent conflicts between different components in the same repository.

What happens if a validation check fails?

The workflow includes a mandatory 'STOP' directive if validation scripts fail, ensuring that broken code or invalid schemas are never tagged or pushed to production.

Why does it emphasize 'atomic' pushes?

Pushing both the commit and the tags in a single command (--tags) prevents scenarios where a version is released without a corresponding tag, or vice versa.

Which files are typically updated during a release?

It synchronizes versions in CHANGELOG.md, the plugin's local plugin.json, the global marketplace.json, and optional metadata files.

How does this skill prevent 'dirty commits'?

The skill explicitly forbids global shortcuts like 'git add -A'. Instead, it provides exact commands to stage only the necessary version and CHANGELOG files, followed by a verification step.

Plugin Release Workflow

Name: Plugin Release Workflow
Author: itsdevcoffee

byitsdevcoffee

•

Deployment & DevOps

Automates and standardizes the plugin release process to prevent version mismatches, dirty commits, and missing git tags.

The Plugin Release Workflow skill is a rigorous framework designed to eliminate common human errors during software deployment. It enforces a standardized 10-step checklist that covers semantic versioning, multi-file metadata synchronization, and high-quality CHANGELOG generation. By guiding the user through specific staging commands and mandatory validation checks, it ensures that every release—from minor patches to major updates—remains consistent and professional, even under high-pressure or late-night conditions. It is particularly effective for monorepo environments where tag naming collisions and metadata drift are common risks.

Key Features

01Automated multi-file version synchronization across metadata and marketplace files

02Atomic push operations to ensure commits and tags are synchronized remotely

031 GitHub stars

04Pre-commit validation enforcement to catch schema errors before publication

05Structured CHANGELOG management with mandatory categorization and detail verification

06Monorepo-safe git tagging using standardized plugin-prefixed formats

Use Cases

01Ensuring version consistency across local configuration files and remote marketplace manifests

02Releasing a bug fix or new feature to a specific plugin within a larger monorepo

03Maintaining high-quality release documentation when working under tight deadlines

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add itsdevcoffee/devcoffee-agent-skills release

For use in Claude.ai and ChatGPT

Download Skill