Claude-code-plugins-plus plugin-creator
install
source · Clone the upstream repo
git clone https://github.com/jeremylongshore/claude-code-plugins-plus-skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/jeremylongshore/claude-code-plugins-plus-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/plugins/examples/jeremy-plugin-tool/skills/plugin-creator" ~/.claude/skills/jeremylongshore-claude-code-plugins-plus-plugin-creator-47666f && rm -rf "$T"
manifest:
plugins/examples/jeremy-plugin-tool/skills/plugin-creator/SKILL.mdsource content
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
directory andplugins/.claude-plugin/marketplace.extended.json
installed for JSON generation and validationjq
available at the repository rootpnpm run sync-marketplace
available for post-creation validation./scripts/validate-all-plugins.sh
Instructions
- Gather requirements from the user request: plugin name (kebab-case), category (
,productivity
,security
,devops
, etc.), plugin type (commands, agents, skills, MCP, or combination), description, and keywords. Default author to the repository owner if unspecified (seetesting
).${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
using the template from.claude-plugin/plugin.json
. Populate all required fields:${CLAUDE_SKILL_DIR}/references/file-templates.md
,name
(defaultversion
),1.0.0
,description
(name and email),author
,repository
(default MIT), andlicense
(minimum 2).keywords - Generate
with installation instructions, usage examples, a description section, and contributor information.README.md - Create a
file with MIT license text (or the specified license).LICENSE - Generate component files based on the plugin type:
- Commands: create
with proper YAML frontmatter (commands/[command-name].md
,name
,description
).model - Agents: create
with YAML frontmatter includingagents/[agent-name].md
field.model - Skills: create
with frontmatter (skills/[skill-name]/SKILL.md
,name
,description
).allowed-tools - MCP: create
,package.json
,tsconfig.json
, andsrc/index.ts
..mcp.json
- Commands: create
- Add the new plugin entry to
with matching name, version, category, description, source path, and keywords..claude-plugin/marketplace.extended.json - Run
to regeneratepnpm run sync-marketplace
.marketplace.json - Validate the new plugin by running
. Fix any reported issues before completion../scripts/validate-all-plugins.sh plugins/[category]/[plugin-name]/
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 directory or marketplace catalog | Choose a unique name; check existing plugins with |
| Invalid category | Category not recognized by marketplace schema | Use one of the valid categories: , , , , , , , |
| JSON syntax error in generated files | Malformed template output | Run on each generated JSON file and fix syntax |
| Marketplace sync failure | New entry has schema violations | Verify all required fields are present in the 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
-- detailed creation workflow${CLAUDE_SKILL_DIR}/references/plugin-creation-process.md
-- templates for${CLAUDE_SKILL_DIR}/references/file-templates.md
, commands, agents, and skillsplugin.json
-- creation scenario walkthroughs${CLAUDE_SKILL_DIR}/references/examples.md
-- error handling patterns${CLAUDE_SKILL_DIR}/references/errors.md