plugin-forge

1# CC Plugin Forge
2 
3## Purpose
4 
5Build and manage Claude Code plugins with correct structure, manifests, and marketplace integration. Includes workflows, automation scripts, and reference docs.
6 
7## When to Use
8 
9- Creating new plugins for a marketplace
10- Adding/modifying plugin components (commands, skills, agents, hooks)
11- Updating plugin versions
12- Working with plugin or marketplace manifests
13- Setting up local plugin testing
14- Publishing plugins
15 
16## Getting Started
17 
18### Create New Plugin
19 
20Use `create_plugin.py` to generate plugin structure:
21 
22```bash
23python scripts/create_plugin.py plugin-name \
24  --marketplace-root /path/to/marketplace \
25  --author-name "Your Name" \
26  --author-email "your.email@example.com" \
27  --description "Plugin description" \
28  --keywords "keyword1,keyword2" \
29  --category "productivity"
30```
31 
32This automatically:
33 
34- Creates plugin directory structure
35- Generates `plugin.json` manifest
36- Creates README template
37- Updates `marketplace.json`
38 
39### Bump Version
40 
41Use `bump_version.py` to update versions in both manifests:
42 
43```bash
44python scripts/bump_version.py plugin-name major|minor|patch \
45  --marketplace-root /path/to/marketplace
46```
47 
48Semantic versioning:
49 
50- **major**: Breaking changes (1.0.0 → 2.0.0)
51- **minor**: New features, refactoring (1.0.0 → 1.1.0)
52- **patch**: Bug fixes, docs (1.0.0 → 1.0.1)
53 
54## Development Workflow
55 
56### 1. Create Structure
57 
58Manual approach (if not using script):
59 
60```bash
61mkdir -p plugins/plugin-name/.claude-plugin
62…