Plugin Creator

Automated plugin scaffolding for Claude Code following official structure and best practices.

When to Use

• •User says "create a plugin"
• •User wants to scaffold new plugin structure
• •User needs to add plugin to marketplace

Quick Start

Run the script with plugin description:

tsx scripts/create-plugin.ts "manages deployment workflows"

The script will:

1. •Parse description → kebab-case name
2. •Extract keywords from description
3. •Check for name conflicts in marketplace
4. •Create plugin directory structure
5. •Generate plugin.json and README.md
6. •Update marketplace.json

Workflow

Step 1: Parse User Input

From user request, extract plugin description. Examples:

• •"create a plugin that manages deployment workflows" → "manages deployment workflows"
• •"create plugin for database migrations" → "database migrations"

Step 2: Run Script

tsx ./plugins/meta-work/skills/plugin-creator/scripts/create-plugin.ts "<description>"

Script handles:

• •Name generation: Converts to kebab-case, removes filler words
• •Keywords: Extracts 3-5 relevant terms
• •Conflict checking: Verifies name availability in marketplace
• •Directory creation: plugins/<name>/{.claude-plugin,commands}/
• •File generation: plugin.json, README.md
• •Marketplace update: Adds entry to .claude-plugin/marketplace.json

Step 3: Verify Output

Script prints:

✅ Plugin created successfully!

Structure:
  ✓ plugins/<name>/.claude-plugin/plugin.json
  ✓ plugins/<name>/commands/ (empty)
  ✓ plugins/<name>/README.md
  ✓ Updated .claude-plugin/marketplace.json

Step 4: Guide Next Steps

After creation, inform user:

• •Plugin scaffolded but empty
• •Add commands: .md files in commands/
• •Add agents: create agents/ directory
• •Add hooks: create hooks/hooks.json
• •Add skills: create skills/<skill-name>/SKILL.md
• •Update README.md as features added

Script Details

Location: ./scripts/create-plugin.ts

No external dependencies - uses only Node.js built-ins

Execution: Requires tsx (available via pnpm in this repo)

Name conversion rules:

• •Removes filler words: "that", "to", "for", "with", "a", "an", "the", etc.
• •Converts to lowercase
• •Replaces spaces with hyphens
• •Removes non-alphanumeric chars (except hyphens)

Example conversions:

• •"manages deployment workflows" → "manages-deployment-workflows"
• •"tool for database migrations" → "database-migrations"
• •"API testing utilities" → "api-testing-utilities"

Error Handling

Conflict detected:

❌ Plugin "plugin-name" already exists in marketplace

Ask user for alternative name, run script again.

Marketplace not found:

⚠️  Marketplace file not found, will create new entry

Script creates new marketplace.json automatically.

Plugin Structure Created

plugins/<name>/
├── .claude-plugin/
│   └── plugin.json          # Metadata, version, keywords
├── commands/                 # Empty, ready for slash commands
└── README.md                 # Template with status and dev instructions

Best Practices

1. •Descriptive names: Clear, specific descriptions → better names/keywords
2. •Scope: One plugin per domain/feature set
3. •Immediate docs: Update README as features added
4. •Versioning: Follow semantic versioning
5. •Keywords: Choose discoverable, relevant tags

Example

Input: "create plugin for database schema migrations"

Execution:

tsx scripts/create-plugin.ts "database schema migrations"

Output:

• •Plugin name: database-schema-migrations
• •Keywords: ["database", "schema", "migrations"]
• •Structure created
• •Marketplace updated
• •Ready for development