---
name: create-plugin
description: Create an empty Claude plugin with basic structure and files.
license: MIT
compatibility: Requires bun package manager and ClaudeKit monorepo structure
allowed-tools: Read, Grep, Glob, Write, Edit, WebFetch(domain:docs.claude.com)
---

# Create Claude Plugin

## When to Use This Skill

Use this skill when:
- Creating a new Claude Code plugin from scratch
- Setting up the standard plugin directory structure
- Adding a new plugin to the ClaudeKit marketplace

**Trigger phrases:**
- "create a new plugin"
- "scaffold a plugin for X"
- "add a plugin called X"

## Instruction

1. Use the `Glob` tool to check if plugin is existing
2. Use Ask Question Tool to confirm overwriting if plugin already exists
3. Create a new directory for the plugin
4. Create a minimal plugin structure for plugin
5. Update the plugin metadata file with basic information
6. Update root README.md to include the new plugin
7. Update `.claude-plugin/marketplace.json` to include the new plugin
8. Update release please config to include the new plugin

## Plugin Structure

```
|- .claude-plugin/
    |- plugin.json
|- commands/ # Omit if no commands
    |- example.md
|- agents/ # Omit if no agents
    |- example-agent.md
|- skills/ # Omit if no skills
    |- example-skill/
        |- SKILL.md
|- hooks/ # Omit if no hooks
    |- hooks.json
|- src/ # Omit if no hook script is needed
    |- example.ts
|- dist/ # Auto-generated, omit
    |- example.js
|- README.md
|- rolldown.config.js # Omit if no src
|- package.json # Omit if no src
|- tsconfig.json # Omit if no src
```

The minimal `plugin.json` is

```json
{
    "name": "plugin-name",
    "version": "0.1.0",
    "description": "A brief description of the plugin",
    "author": {
        "name": "Author Name"
    }
}
```

## Reference

For detailed information on creating Claude plugins, refer to following documentation:

- [Claude Plugin Reference](https://docs.claude.com/en/docs/claude-code/plugins-reference)
- [Claude Hook Reference](https://docs.claude.com/en/docs/claude-code/hooks)
- [Claude Agent](https://docs.claude.com/en/docs/claude-code/sub-agents)
- [Claude Agent Skill](https://docs.claude.com/en/docs/claude-code/skills)