building-skills-marketplace

Building Skills & Marketplace

Complete workflow for creating professional Claude Code skills and publishing them via marketplace.

Features

• TDD Methodology: RED-GREEN-REFACTOR workflow with pressure testing
• Two-Repository Structure: Catalog (marketplace) + Content (skills)
• Verification Checklists: Ensure quality before publication
• Git Tagging & Version Management: Proper versioning for reliable installations
• Slash Command Integration: Make skills discoverable via /help

Installation

From imehr-marketplace:

/plugin marketplace add imehr/imehr-marketplace
/plugin install building-skills-marketplace@imehr-marketplace

Then restart Claude Code.

Usage

Use the /build-skills command to:

1. Create new Claude Code skills
2. Set up marketplace repositories
3. Package skills for distribution
4. Add skills to marketplaces

What This Skill Teaches

Skill Creation

• Write pressure tests FIRST (before skill implementation)
• Create minimal skills that pass tests
• Add slash commands for discoverability
• Follow verification checklists

Marketplace Setup

• Two-repository structure (catalog + content)
• Correct marketplace.json and manifest.json schemas
• Git tagging requirements
• Version management workflows

Common Pitfalls

• Missing git tags (installation fails)
• Version mismatches between marketplace.json and git tags
• No slash commands (skills invisible in /help)
• Testing after writing (violates TDD)

Key Workflows

Creating New Skills

1. Write 3+ pressure test scenarios (RED)
2. Create minimal skill to pass tests (GREEN)
3. Refactor and add explicit counters (REFACTOR)
4. Add slash command
5. Commit and tag

Publishing to Marketplace

1. Create git tag in skill repo: git tag v1.0.0 && git push origin v1.0.0
2. Update marketplace.json with matching version
3. Test clean installation
4. Restart Claude Code to verify

Version Updates

1. Make changes in plugin repository
2. Commit changes
3. Create new tag FIRST: git tag v1.1.0 && git push origin v1.1.0
4. Update marketplace.json version
5. Commit marketplace changes

License

MIT