Create and manage Claude Code plugins with proper structure, manifests, and marketplace integration. Use when creating plugins for a marketplace, adding plugin components (commands, agents, hooks), bumping plugin versions, or working with plugin.json/marketplace.json manifests.

CC Plugin Forge Purpose Build and manage Claude Code plugins with correct structure, manifests, and marketplace integration. Includes workflows, automation scripts, and reference docs. When to Use Creating new plugins for a marketplace Adding/modifying plugin components (commands, skills, agents, hooks) Updating plugin versions Working with plugin or marketplace manifests Setting up local plugin testing Publishing plugins Getting Started Create New Plugin Use create plugin.py to generate plugin structure: This automatically: Creates plugin directory structure Generates plugin.json manifest Creates README template Updates marketplace.json Bump Version Use bump version.py to update versions in both manifests: Semantic versioning: major : Breaking changes (1.0.0 → 2.0.0) minor : New features, refactoring (1.0.0 → 1.1.0) patch : Bug fixes, docs (1.0.0 → 1.0.1) Development Workflow 1. Create Structure Manual approach (if not using script): 2. Plugin Manifest File: plugins/plugin name/.claude plugin/plugin.json 3. Register in Marketplace Update .claude plugin/marketplace.json : 4. Add Components Create in respective directories: Component Location Format Commands commands/ Markdown with frontmatter Skills skills/<name / Directory with SKILL.md Agents agents/ Markdown definitions Hooks hooks/hooks.json Event handlers MCP Servers .mcp.json External integrations 5. Local Testing Plugin Patterns Framework Plugin For framework specific guidance (React, Vue, etc.): Utility Plugin For tools and commands: Domain Plugin For domain specific knowledge: Command Naming Subdirectory based namespacing with : separator: commands/namespace/command.md → /namespace:command commands/simple.md → /simple Examples: commands/prime/vue.md → /prime:vue commands/docs/generate.md → /docs:generate Version Management Important: Update version in BOTH locations: 1. plugins/<name /.claude plugin/plugin.json 2. .claude plugin/marketplace.json Use bump version.py to automate. Git Commits Use conventional commits: Reference Docs Detailed documentation included: Reference Content references/plugin structure.md Directory structure, manifest schema, components references/marketplace schema.md Marketplace format, plugin entries, distribution references/workflows.md Step by step workflows, patterns, publishing Scripts Script Purpose scripts/create plugin.py Scaffold new plugin scripts/bump version.py Update versions

plugin-forge