claude-plugin-distribution

Package and distribute Claude Code plugins with versioning and GitHub releases.

28|1|Updated Aug 30, 2025
One-click install
npx skills add https://github.com/outfitter-dev/agents --skill claude-plugin-distribution
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-plugin-distribution
Source: https://github.com/outfitter-dev/agents/tree/main/claude-dev/skills/claude-plugin-distribution
Command: npx skills add https://github.com/outfitter-dev/agents --skill claude-plugin-distribution

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Packaging, versioning, and publishing Claude Code plugins can be a manual and error-prone process. This Skill streamlines the entire distribution workflow, ensuring your plugins are production-ready, well-documented, and easily shareable.

Core Features & Use Cases

  • Structured Packaging: Guides through creating distribution-ready ZIP packages with the correct file structure and exclusions.
  • Versioning & Documentation: Provides templates and best practices for semantic versioning, READMEs, and CHANGELOGs.
  • GitHub Releases & CI/CD: Sets up workflows for publishing plugins to GitHub releases and integrating with automated validation pipelines.
  • Use Case: Prepare your 'my-plugin' for a new release by updating its version, generating a changelog entry, creating a distribution-ready ZIP package, and publishing it to GitHub with automated release notes.

Quick Start

Prepare your 'my-plugin' for release by updating its version to 1.0.0, creating a changelog entry, and generating a ZIP package.

Frequently Asked Questions about claude-plugin-distribution

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

FAQPage Schema
How do I package a Claude plugin for distribution?

Package your plugin by creating a distribution-ready ZIP file with the correct directory structure, including plugin.json, README, LICENSE, CHANGELOG, and your plugin code. The Skill guides you through structuring files, excluding unnecessary items, and validating the package meets marketplace requirements.

What versioning approach should I use for Claude plugin releases?

Use semantic versioning for Claude plugins, updating version numbers in plugin.json and CHANGELOG to track breaking changes, new features, and fixes. This Skill provides templates and best practices for maintaining version consistency across release artifacts and GitHub tags.

Can I automate publishing Claude plugins to GitHub?

Yes. This Skill sets up GitHub Actions workflows to automate plugin validation, packaging, and publishing to GitHub releases with generated release notes. CI/CD integration ensures your plugins are tested and distributed reliably without manual steps.

What files must be included in a Claude plugin release?

A valid Claude plugin distribution requires plugin.json with correct metadata, a README explaining functionality, a LICENSE file specifying terms, and a CHANGELOG documenting version history and changes. This Skill enforces these requirements and provides templates for each.

How do I prepare an existing plugin for its first marketplace release?

Update the plugin version to a release number, write a CHANGELOG entry documenting initial features, generate a distribution ZIP with correct structure and file inclusions, and publish to GitHub with release notes. This Skill streamlines the entire workflow end-to-end.

What directory structure does a Claude plugin package need?

A distribution-ready package uses a structured layout with plugin.json at the root, source code in a src or lib directory, documentation files (README, LICENSE, CHANGELOG) at the top level, and excludes build artifacts, node_modules, and development files. This Skill enforces the correct structure automatically.