marketplace-manager

Marketplace Manager

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

Quick Reference

Task	Command
Validate all plugins	./scripts/validate.sh
Validate single plugin	./scripts/validate.sh plugins/<name>
Regenerate indices	./scripts/generate-index.sh
Check marketplace status	Read .claude-plugin/marketplace.json

Workflows

Adding a New Plugin

1. Create plugin from template

   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

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

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

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

7. Regenerate indices

   ./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

Error	Fix
Missing manifest	Create .claude-plugin/plugin.json
Invalid JSON	Fix JSON syntax errors
Missing name	Add "name": "plugin-name"
Invalid name format	Use lowercase, alphanumeric, hyphens only
Missing version	Add "version": "1.0.0"
Invalid version	Use semver format (x.y.z)
Missing description	Add description (10-500 chars)
No components	Add at least one skill, command, agent, or hook