marketplace-builder

The marketplace-builder skill provides structured guidance for creating and configuring Claude Code marketplaces and plugins. It addresses the complexity of organizing, distributing, and managing reusable components such as commands, agents, skills, hooks, and MCP servers. A key concept emphasized by this skill is the distinction between a marketplace and a plugin: a marketplace is a JSON catalog that indexes plugins, while a plugin is a packaged collection of components. Marketplaces do not host plugins; instead, they reference plugins that may reside in GitHub repositories, other git services, private repositories, or local directories. This separation enables flexible distribution models without coupling hosting and discovery.

The skill includes JSON schema references for marketplace.json, plugin.json, and team-level settings.json configurations. It documents supported source types, including GitHub repositories, generic Git URLs, directory paths, and relative paths. It also provides command-line references for adding, listing, updating, installing, enabling, disabling, and uninstalling plugins, along with structure validation using a validation command. Additionally, it outlines a six-phase workflow beginning with requirements gathering, where distribution type, plugin scope, target audience, and hosting environment are clarified before architectural decisions are made.

This skill is intended for developers, teams, and organizations that need to distribute Claude Code extensions in a structured and maintainable way. It supports scenarios ranging from personal plugin development to company-wide distribution and public community sharing. By following the documented architecture patterns and configuration formats, users can implement consistent plugin ecosystems tailored to their distribution strategy.