create-claude-plugin

Scaffold a Claude Code plugin in seconds.

npx create-claude-plugin my-plugin

Features

• Interactive prompts — plugin name, description, author, and component selection
• Zero dependencies — only Node.js built-ins
• Full plugin structure — generates valid plugin.json, example skills, agents, hooks, MCP/LSP configs
• Git ready — auto-initializes a git repo with an initial commit
• Non-interactive mode — use --yes to skip prompts and scaffold with defaults

Usage

# Interactive
npx create-claude-plugin my-plugin

# Non-interactive (uses defaults)
npx create-claude-plugin my-plugin --yes

Options

| Flag | Description | | ---------------- | ------------------------------ | | -y, --yes | Skip prompts, use defaults | | --no-git | Skip git init | | -v, --version| Show version | | -h, --help | Show help |

Components

When prompted, you can include any combination of:

| Component | What it generates | | ------------- | ------------------------------------------ | | Skills | skills/hello/SKILL.md — example skill | | Agents | agents/example.md — custom agent | | Hooks | hooks/hooks.json — event hook config | | MCP Servers | .mcp.json + scripts/server.js stub | | LSP Servers | .lsp.json — language server config |

Generated structure

my-plugin/
├── .claude-plugin/
│   └── plugin.json        # Plugin manifest
├── skills/
│   └── hello/
│       └── SKILL.md       # Example skill
├── .gitignore
├── LICENSE
└── README.md

(Additional files are created based on your component selection.)

Testing your plugin

cd my-plugin
claude --plugin-dir .

Documentation

• Create plugins
• Plugin reference
• Discover plugins

Contributing

This project uses Conventional Commits and semantic-release for automated versioning.

Commit message format:

feat: add template flag        → minor release (1.x.0)
fix: handle empty description  → patch release (1.0.x)
feat!: redesign CLI interface  → major release (x.0.0)
chore: update dependencies     → no release

License

MIT