building-skills-marketplace

Publishing a Claude Code skill requires following a two-repository marketplace workflow: write tests first using red-green-refactor methodology, create a skill manifest with name and version, define slash commands, add documentation, create git tags, and deploy to both catalog and content repositories. This ensures your skill is discoverable and correctly integrated.

Test-driven development (TDD) with red-green-refactor methodology is enforced for skill development. Write pressure tests upfront before implementation, document results in TEST_RESULTS.md, and ensure tests pass before publishing to maintain high quality and catch integration issues early.

A valid marketplace.json schema must include owner and metadata fields; the skills manifest requires name, version, directories, and commands; slash commands must be present; TEST_RESULTS.md documentation is mandatory; and git tags must be created before publishing. All requirements must be met for successful deployment.

Define slash commands in your skill manifest, then validate both the manifest and marketplace.json against the schema. After validation passes and git tags are created, complete restart steps post-installation to ensure commands become available in the Claude Code environment.

Yes, the two-repository marketplace workflow applies to both public and internal skill distributions. The process covers skill creation, testing, manifest configuration, version tagging, and deployment across multiple catalogs, making it adaptable to different organizational marketplace setups.