Plugin Creator
Overview
Scaffolds new Claude Code plugins with proper directory structure, required files, marketplace catalog integration, and full validation. Supports all plugin types: command plugins, agent plugins, skill plugins, MCP server plugins, and hybrid combinations.
Prerequisites
- Write access to the
plugins/ directory and .claude-plugin/marketplace.extended.json
jq installed for JSON generation and validation
pnpm run sync-marketplace available at the repository root
./scripts/validate-all-plugins.sh available for post-creation validation
Instructions
- Gather requirements from the user request: plugin name (kebab-case), category (
productivity, security, devops, testing, etc.), plugin type (commands, agents, skills, MCP, or combination), description, and keywords. Default author to the repository owner if unspecified (see ${CLAUDE_SKILL_DIR}/references/plugin-creation-process.md).
- Create the plugin directory structure under
plugins/[category]/[plugin-name]/:plugins/[category]/[plugin-name]/
├── .claude-plugin/
│ └── plugin.json
├── README.md
├── LICENSE
└── [commands/ | agents/ | skills/ | hooks/ | mcp/]
- Generate
.claude-plugin/plugin.json using the template from ${CLAUDE_SKILL_DIR}/references/file-templates.md. Populate all required fields: name, version (default 1.0.0), description, author (name and email), repository, license (default MIT), and keywords (minimum 2).
- Generate
README.md with installation instructions, usage examples, a description section, and contributor information.
- Create a
LICENSE file with MIT license text (or the specified license).
- Generate component files based on the plugin type:
- Commands: create
commands/[command-name].md with proper YAML frontmatter (name, description, model).
- Agents: create
agents/[agent-name].md with YAML frontmatter including model field.
- Skills: create
skills/[skill-name]/SKILL.md with frontmatter (name, description, allowed-tools).
- MCP: create
package.json, tsconfig.json, src/index.ts, and .mcp.json.
- Add the new plugin entry to
.claude-plugin/marketplace.extended.json with matching name, version, category, description, source path, and keywords.
- Run
pnpm run sync-marketplace to regenerate marketplace.json.
- Validate the new plugin by running
./scripts/validate-all-plugins.sh plugins/[category]/[plugin-name]/. Fix any reported issues before completion.
Output
A complete, CI-ready plugin containing:
- All required files (
plugin.json, README.md, LICENSE)
- Component files matching the requested plugin type with proper frontmatter
- Marketplace catalog entry in
marketplace.extended.json
- Synchronized
marketplace.json
- Validation confirmation from
validate-all-plugins.sh
Error Handling
| Error |
Cause |
Solution |
| Plugin name already exists |
Duplicate name in plugins/ directory or marketplace catalog |
Choose a unique name; check existing plugins with ls plugins/*/ |
| Invalid category |
Category not recognized by marketplace schema |
Use one of the valid categories: productivity, security, devops, testing, community, examples, packages, mcp |
| JSON syntax error in generated files |
Malformed template output |
Run jq empty on each generated JSON file and fix syntax |
| Marketplace sync failure |
New entry has schema violations |
Verify all required fields are present in the marketplace.extended.json entry |
| Validation script failure |
Missing required files or incorrect structure |
Review the validation output and create/fix the flagged files |
Examples
Create a command plugin:
Trigger: "Create a new security plugin called 'owasp-scanner' with commands."
Process: Create plugins/security/owasp-scanner/ directory, generate plugin.json, README.md, LICENSE, and commands/scan.md with proper frontmatter. Add to marketplace, sync, validate (see ${CLAUDE_SKILL_DIR}/references/examples.md).
Scaffold a skills plugin:
Trigger: "Scaffold a skills plugin for code review."
Process: Create plugin directory with skills/code-review/SKILL.md containing trigger keywords for code review tasks. Generate plugin.json with appropriate keywords. Add to marketplace, sync, validate.
Create an MCP server plugin:
Trigger: "Create a new MCP plugin for database queries."
Process: Create plugins/mcp/db-query/ with package.json (including @modelcontextprotocol/sdk dependency), tsconfig.json, src/index.ts, .mcp.json, and standard files. Add to marketplace, sync, validate.
Resources
${CLAUDE_SKILL_DIR}/references/plugin-creation-process.md -- detailed creation workflow
${CLAUDE_SKILL_DIR}/references/file-templates.md -- templates for plugin.json, commands, agents, and skills
${CLAUDE_SKILL_DIR}/references/examples.md -- creation scenario walkthroughs
${CLAUDE_SKILL_DIR}/references/errors.md -- error handling patterns
1---
2name: plugin-creator-2
3description: |
4 Create automatically creates new AI assistant code plugins with proper structure, validation, and marketplace integration when user mentions creating a plugin, new plugin, or plugin from template. specific to AI assistant-code-plugins repository workflow. Use when generating or creating new content. Trigger with phrases like 'generate', 'create', or 'scaffold'.
5allowed-tools: Write, Read, Grep, Bash(cmd:*)
6version: 1.0.0
7author: Jeremy Longshore <jeremy@intentsolutions.io>
8license: MIT
9compatible-with: claude-code, codex, openclaw
10metadata:
11 source: https://skillmd.com/skills/micsapp/plugin-creator-2
12---
13
14# Plugin Creator
15
16## Overview
17
18Scaffolds new Claude Code plugins with proper directory structure, required files, marketplace catalog integration, and full validation. Supports all plugin types: command plugins, agent plugins, skill plugins, MCP server plugins, and hybrid combinations.
19
20## Prerequisites
21
22- Write access to the `plugins/` directory and `.claude-plugin/marketplace.extended.json`
23- `jq` installed for JSON generation and validation
24- `pnpm run sync-marketplace` available at the repository root
25- `./scripts/validate-all-plugins.sh` available for post-creation validation
26
27## Instructions
28
291. Gather requirements from the user request: plugin name (kebab-case), category (`productivity`, `security`, `devops`, `testing`, etc.), plugin type (commands, agents, skills, MCP, or combination), description, and keywords. Default author to the repository owner if unspecified (see `${CLAUDE_SKILL_DIR}/references/plugin-creation-process.md`).
302. Create the plugin directory structure under `plugins/[category]/[plugin-name]/`:
31 ```
32 plugins/[category]/[plugin-name]/
33 ├── .claude-plugin/
34 │ └── plugin.json
35 ├── README.md
36 ├── LICENSE
37 └── [commands/ | agents/ | skills/ | hooks/ | mcp/]
38 ```
393. Generate `.claude-plugin/plugin.json` using the template from `${CLAUDE_SKILL_DIR}/references/file-templates.md`. Populate all required fields: `name`, `version` (default `1.0.0`), `description`, `author` (name and email), `repository`, `license` (default MIT), and `keywords` (minimum 2).
404. Generate `README.md` with installation instructions, usage examples, a description section, and contributor information.
415. Create a `LICENSE` file with MIT license text (or the specified license).
426. Generate component files based on the plugin type:
43 - **Commands**: create `commands/[command-name].md` with proper YAML frontmatter (`name`, `description`, `model`).
44 - **Agents**: create `agents/[agent-name].md` with YAML frontmatter including `model` field.
45 - **Skills**: create `skills/[skill-name]/SKILL.md` with frontmatter (`name`, `description`, `allowed-tools`).
46 - **MCP**: create `package.json`, `tsconfig.json`, `src/index.ts`, and `.mcp.json`.
477. Add the new plugin entry to `.claude-plugin/marketplace.extended.json` with matching name, version, category, description, source path, and keywords.
488. Run `pnpm run sync-marketplace` to regenerate `marketplace.json`.
499. Validate the new plugin by running `./scripts/validate-all-plugins.sh plugins/[category]/[plugin-name]/`. Fix any reported issues before completion.
50
51## Output
52
53A complete, CI-ready plugin containing:
54- All required files (`plugin.json`, `README.md`, `LICENSE`)
55- Component files matching the requested plugin type with proper frontmatter
56- Marketplace catalog entry in `marketplace.extended.json`
57- Synchronized `marketplace.json`
58- Validation confirmation from `validate-all-plugins.sh`
59
60## Error Handling
61
62| Error | Cause | Solution |
63|---|---|---|
64| Plugin name already exists | Duplicate name in `plugins/` directory or marketplace catalog | Choose a unique name; check existing plugins with `ls plugins/*/` |
65| Invalid category | Category not recognized by marketplace schema | Use one of the valid categories: `productivity`, `security`, `devops`, `testing`, `community`, `examples`, `packages`, `mcp` |
66| JSON syntax error in generated files | Malformed template output | Run `jq empty` on each generated JSON file and fix syntax |
67| Marketplace sync failure | New entry has schema violations | Verify all required fields are present in the `marketplace.extended.json` entry |
68| Validation script failure | Missing required files or incorrect structure | Review the validation output and create/fix the flagged files |
69
70## Examples
71
72**Create a command plugin:**
73Trigger: "Create a new security plugin called 'owasp-scanner' with commands."
74Process: Create `plugins/security/owasp-scanner/` directory, generate `plugin.json`, `README.md`, `LICENSE`, and `commands/scan.md` with proper frontmatter. Add to marketplace, sync, validate (see `${CLAUDE_SKILL_DIR}/references/examples.md`).
75
76**Scaffold a skills plugin:**
77Trigger: "Scaffold a skills plugin for code review."
78Process: Create plugin directory with `skills/code-review/SKILL.md` containing trigger keywords for code review tasks. Generate `plugin.json` with appropriate keywords. Add to marketplace, sync, validate.
79
80**Create an MCP server plugin:**
81Trigger: "Create a new MCP plugin for database queries."
82Process: Create `plugins/mcp/db-query/` with `package.json` (including `@modelcontextprotocol/sdk` dependency), `tsconfig.json`, `src/index.ts`, `.mcp.json`, and standard files. Add to marketplace, sync, validate.
83
84## Resources
85
86- `${CLAUDE_SKILL_DIR}/references/plugin-creation-process.md` -- detailed creation workflow
87- `${CLAUDE_SKILL_DIR}/references/file-templates.md` -- templates for `plugin.json`, commands, agents, and skills
88- `${CLAUDE_SKILL_DIR}/references/examples.md` -- creation scenario walkthroughs
89- `${CLAUDE_SKILL_DIR}/references/errors.md` -- error handling patterns