init

Initialize Plugin

Create the standard directory structure and files for a new Claude Code plugin.

Arguments

• $1 (required): Plugin name in kebab-case (e.g., my-awesome-plugin)

What This Command Does

1. Creates the plugin directory structure:
   • .claude-plugin/ with plugin.json
   • commands/ directory
   • agents/ directory
   • skills/ directory
   • hooks/ directory with hooks.json
   • scripts/ directory
2. Generates a starter plugin.json with the provided name
3. Creates a README.md template
4. Provides next steps

Instructions

Validation

First, validate the plugin name:

• Must be provided (not empty)
• Should be kebab-case (lowercase with hyphens)
• Should not contain spaces or special characters

If validation fails, explain the requirements and ask for a valid name.

Create Directory Structure

Create these directories:

$1/
├── .claude-plugin/
├── commands/
├── agents/
├── skills/
├── hooks/
└── scripts/

Create plugin.json

Create .claude-plugin/plugin.json with this template:

{
  "name": "$1",
  "version": "0.1.0",
  "description": "Brief description of what this plugin does",
  "author": {
    "name": "Your Name",
    "email": "[email protected]"
  },
  "license": "MIT",
  "keywords": ["keyword1", "keyword2"]
}

Create hooks.json

Create hooks/hooks.json with a basic structure:

{
  "description": "Plugin hooks",
  "hooks": {}
}

Create README.md

Create README.md with this template:

# $1

[Brief description of what this plugin does]

## Installation

```bash
/plugin install $1@marketplace-name

Commands

[List commands here]

Usage

[Provide examples]

### Create Validation Script

Create `scripts/validate-plugin.sh` with executable permissions:

```bash
#!/usr/bin/env bash
set -euo pipefail

# Basic plugin structure validation
[ -f ".claude-plugin/plugin.json" ] || { echo "Missing plugin.json" >&2; exit 2; }
exit 0

Make it executable: chmod +x scripts/validate-plugin.sh