Marketplace Manager

Manage the fakoli-plugins marketplace: add/remove plugins, validate manifests, and regenerate registry indices.

Quick Reference

Workflows

Adding a New Plugin

1. •

   Create plugin from template

   bash

   cp -r templates/basic plugins/<plugin-name>
   

2. •

   Update manifest at plugins/<plugin-name>/.claude-plugin/plugin.json:

   • •Set name (lowercase, alphanumeric, hyphens only)
   • •Set version (semver format: x.y.z)
   • •Write description (10-500 chars)
   • •Add author info
   • •Set extended.category (productivity|code-quality|devops|integrations|utilities)
   • •Add relevant extended.tags
3. •

   Add plugin components (at least one required):

   • •Skills: skills/<skill-name>/SKILL.md
   • •Commands: commands/<cmd>.json
   • •Agents: agents/<agent>.json
   • •Hooks: hooks/<hook>.json
4. •

   Update documentation:

   • •Edit README.md with usage instructions
   • •Update CHANGELOG.md
5. •

   Validate

   bash

   ./scripts/validate.sh plugins/<plugin-name>
   

6. •

   Register in marketplace Add entry to .claude-plugin/marketplace.json plugins array:

   json

   {
     "name": "<plugin-name>",
     "path": "plugins/<plugin-name>",
     "version": "1.0.0"
   }
   

7. •

   Regenerate indices

   bash

   ./scripts/generate-index.sh
   

Removing a Plugin

1. •Remove from .claude-plugin/marketplace.json plugins array
2. •Delete plugin directory: rm -rf plugins/<plugin-name>
3. •Regenerate indices: ./scripts/generate-index.sh

Validating Plugins

Validate all plugins:

./scripts/validate.sh

Validate specific plugin:

./scripts/validate.sh plugins/<plugin-name>

Validation checks:

• •JSON syntax validity
• •Required fields: name, version, description
• •Name format (lowercase, alphanumeric, hyphens)
• •Version format (semver)
• •README.md presence
• •CHANGELOG.md presence
• •At least one component (skill/command/agent/hook)

Regenerating Registry Indices

./scripts/generate-index.sh

Generates:

• •registry/index.json - Full plugin index with metadata
• •registry/categories.json - Plugins grouped by category
• •registry/tags.json - Tag cloud with counts

Checking Marketplace Status

Read current state:

cat .claude-plugin/marketplace.json
cat registry/index.json

Quick stats:

jq '.pluginCount' registry/index.json
jq '.categories | length' registry/categories.json
jq '.totalTags' registry/tags.json

Plugin Manifest Schema

Required fields:

{
  "name": "plugin-name",
  "version": "1.0.0",
  "description": "10-500 character description"
}

Extended metadata:

{
  "extended": {
    "category": "utilities",
    "tags": ["tag1", "tag2"],
    "compatibility": {
      "claudeCodeVersion": ">=1.0.0",
      "platforms": ["darwin", "linux", "win32"]
    },
    "dependencies": {
      "npm": [],
      "pip": [],
      "binaries": []
    }
  }
}

Directory Structure

fakoli-plugins/
├── .claude-plugin/marketplace.json  # Registry config
├── plugins/<plugin-name>/           # First-party plugins
│   ├── .claude-plugin/plugin.json
│   ├── skills/
│   ├── README.md
│   └── CHANGELOG.md
├── external_plugins/                # Modified external plugins
├── registry/                        # Auto-generated indices
├── scripts/                         # Validation tools
└── templates/basic/                 # Plugin template

Validation Error Reference