softaworks/agent-toolkit / skills/plugin-forge
plugin-forge
UnverifiedCreate 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.
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 8.6 KB |
| SKILL.md | skill md | 5.1 KB |
| references/marketplace-schema.md | markdown | 2.4 KB |
| references/plugin-structure.md | markdown | 2.7 KB |
| references/workflows.md | markdown | 3.8 KB |
| scripts/bump_version.pyexecutable | script | 3.3 KB |
| scripts/create_plugin.pyexecutable | script | 4.5 KB |
references/workflows.md
View on GitHub# Plugin Development Workflows
## Creating a New Plugin
### 1. Create Plugin Directory Structure
```bash
mkdir -p plugins/plugin-name/.claude-plugin
mkdir -p plugins/plugin-name/commands
mkdir -p plugins/plugin-name/skills
```
### 2. Create Plugin Manifest
Create `plugins/plugin-name/.claude-plugin/plugin.json`:
```json
{
"name": "plugin-name",
"version": "0.1.0",
"description": "Plugin description",
"author": {
"name": "Your Name",
"email": "your.email@example.com"
},
"keywords": ["keyword1", "keyword2"]
}
```
### 3. Add Plugin to Marketplace
Update `.claude-plugin/marketplace.json` by adding entry to `plugins` array:
```json
{
"name": "plugin-name",
"source": "./plugins/plugin-name",
"description": "Plugin description",
"version": "0.1.0",
"keywords": ["keyword1", "keyword2"],
"category": "productivity"
}
```
### 4. Add Plugin Components
Create commands, skills, agents, or hooks as needed in their respective directories.
## Version Bumping
When making changes to a plugin, update version in **both** locations:
1. `plugins/<plugin-name>/.claude-plugin/plugin.json`
2. `.claude-plugin/marketplace.json` (matching plugin entry)
**Semantic versioning:**
- **Major (x.0.0)**: Breaking changes
- **Minor (0.x.0)**: New features, refactoring
- **Patch (0.0.x)**: Bug fixes, documentation only
## Local Testing Workflow
### Initial Setup
```bash
# Add marketplace
/plugin marketplace add /path/to/marketplace-root
# Install plugin
/plugin install plugin-name@marketplace-name
```
### Iterative Testing
After making changes to a plugin:
```bash
# Uninstall
/plugin uninstall plugin-name@marketplace-name
# Reinstall
/plugin install plugin-name@marketplace-name
# Restart Claude Code to load changes
```
**Note:** Claude Code caches plugin files, so restart may be required for changes to take effect.
## Publishing Workflow
### 1. Commit Changes
Use conventional commits:
```bash
git add .
git commit -m "feat: add new plugin"
git commit -m "fix: correct plugin manifest"
git commit -m "docs: update plugin README"
```
### 2. Push to Repository
```bash
git push origin main
```
### 3. Distribution
**GitHub-hosted marketplace:**
Users add via:
```bash
/plugin marketplace add owner/repo
/plugin install plugin-name@marketplace-name
```
**Local marketplace:**
Users add via absolute path:
```bash
/plugin marketplace add /path/to/marketplace
```
## Command Naming Convention
Commands use subdirectory-based namespacing:
- File: `commands/namespace/command.md`
- Invoked as: `/namespace:command`
- The `:` represents directory separator `/`
**Examples:**
- `commands/prime/vue.md` → `/prime:vue`
- `commands/docs/generate.md` → `/docs:generate`
- `commands/simple.md` → `/simple`
## Common Plugin Patterns
### Framework Plugin
Structure for framework-specific guidance (React, Vue, Nuxt, etc.):
```
plugins/framework-name/
├── .claude-plugin/plugin.json
├── skills/
│ └── framework-name/
│ ├── SKILL.md # Quick reference
│ └── references/ # Library-specific patterns
├── commands/
│ └── prime/ # Namespace for loading patterns
│ ├── components.md
│ └── framework.md
└── README.md
```
### Utility Plugin
Structure for tools and utilities:
```
plugins/utility-name/
├── .claude-plugin/plugin.json
├── commands/
│ ├── action1.md
│ └── action2.md
└── README.md
```
### Domain Plugin
Structure for domain-specific knowledge:
```
plugins/domain-name/
├── .claude-plugin/plugin.json
├── skills/
│ └── domain-name/
│ ├── SKILL.md
│ ├── references/
│ │ ├── schema.md
│ │ └── policies.md
│ └── scripts/
│ └── automation.py
└── README.md
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |