Initial commit

2025-11-29 18:00:36 +08:00
commit c83b4639c5
49 changed files with 18594 additions and 0 deletions
--- a/commands/new-plugin.md
+++ b/commands/new-plugin.md
@@ -0,0 +1,145 @@
+---
+description: Interactive wizard for creating new plugins in lunar-claude marketplace
+---
+
+# 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:
+
+   ```bash
+   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:
+
+   ```json
+   {
+     "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
+
+```bash
+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