New Plugin

Create a new plugin in the lunar-claude marketplace using the template structure.

Process

Follow these steps to create a properly structured plugin:

Step 1: Gather Plugin Information

Ask the user for:

• Plugin name (kebab-case, no spaces)
• Description (one-line summary)
• Category (meta, infrastructure, devops, or homelab)
• Keywords (comma-separated for searchability)
• Components needed (skills, agents, hooks, commands)

Step 2: Validate Plugin Name

Check that:

• Name uses kebab-case format
• Name is unique (not in current marketplace.json)
• Name is descriptive and clear

Step 3: Create Plugin Directory

1. Copy template to appropriate category:

   cp -r templates/plugin-template/ plugins/<category>/<plugin-name>/
   

2. Navigate to new plugin directory

Step 4: Customize Plugin Files

1. Update .claude-plugin/plugin.json:

   • Replace PLUGIN_NAME with actual name
   • Replace PLUGIN_DESCRIPTION with description
   • Replace KEYWORD1, KEYWORD2 with actual keywords

2. Update README.md:

   • Replace all PLUGIN_NAME placeholders
   • Replace PLUGIN_DESCRIPTION
   • Remove component sections not being used

3. Remove unused component directories:

   • If not using agents, remove agents/
   • If not using skills, remove skills/
   • If not using hooks, remove hooks/
   • Always keep commands/ (can be empty with .gitkeep)

Step 5: Update Marketplace Manifest

1. Read current .claude-plugin/marketplace.json

2. Add new plugin entry to plugins array:

   {
     "name": "plugin-name",
     "source": "./plugins/<category>/<plugin-name>",
     "description": "plugin description",
     "version": "0.1.0",
     "category": "category-name",
     "keywords": ["keyword1", "keyword2"],
     "author": {
       "name": "basher83"
     }
   }
   

3. Write updated marketplace.json

4. Validate JSON syntax with jq

Step 6: Create Initial Commit

git add plugins/<category>/<plugin-name>/
git add .claude-plugin/marketplace.json
git commit -m "feat: add <plugin-name> plugin

Create new <category> plugin: <description>
Initial version 0.1.0

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>"

Step 7: Provide Next Steps

Tell the user:

Plugin created successfully!

Location: plugins/<category>/<plugin-name>/

Next steps:

1. Add your components (skills, agents, hooks, commands)
2. Update README.md with usage examples
3. Test locally: /plugin marketplace add .
4. Install: /plugin install <plugin-name>@lunar-claude

Examples

Example: Creating infrastructure plugin

User input:

• Name: terraform-tools
• Description: Terraform and OpenTofu helpers
• Category: infrastructure
• Keywords: terraform, opentofu, iac
• Components: skills, commands

Result:

• Created plugins/infrastructure/terraform-tools/
• Added to marketplace.json under infrastructure category
• Ready for component development

Example: Creating homelab plugin

User input:

• Name: proxmox-ops
• Description: Proxmox cluster operations
• Category: homelab
• Keywords: proxmox, virtualization, homelab
• Components: agents, commands

Result:

• Created plugins/homelab/proxmox-ops/
• Added to marketplace.json under homelab category
• Removed unused skills and hooks directories