cc-marketplace: Instructions file for Claude Code

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Repository Overview

This is a Claude Code plugin marketplace - a monorepo containing example plugins demonstrating different plugin capabilities. Users install this marketplace to access all contained plugins.

Architecture

Two-Level Structure

The marketplace has a registry (.claude-plugin/marketplace.json) that references individual plugins (plugins/*/). Each plugin is self-contained with its own metadata.

.claude-plugin/marketplace.json   → Central registry (lists all plugins)
plugins/python-dev/               → Comprehensive Python dev plugin (skills + commands)

Plugin Types & Key Differences

1. Slash Commands (user-invoked): Filename in commands/*.md becomes command name (e.g., hello.md → /hello)
2. Agent Skills (autonomous): Must be in skills/skill-name/SKILL.md format. Claude decides when to invoke.
3. MCP Servers (external tools): Configured in plugin's plugin.json under "mcp" key with command/args

Required Plugin Files

Every plugin needs:

• .claude-plugin/plugin.json - Metadata (name, version, author, description)
• README.md - User documentation

Adding a New Plugin

1. Copy template:

   cp -r plugins/python-dev plugins/my-plugin       # Use python-dev as template
   

2. Update metadata in plugins/my-plugin/.claude-plugin/plugin.json:

   • Change name, description, version
   • Update author (name and email)

3. Register in .claude-plugin/marketplace.json:

   • Add entry to plugins array
   • Set source to "./plugins/my-plugin"
   • Choose appropriate category: development, testing, documentation, productivity, devops

4. Test locally before committing:

   cp -r plugins/my-plugin ~/.claude/plugins/
   # Reload Claude Code or use /plugin list
   

Validation Commands

# Validate marketplace.json structure
cat .claude-plugin/marketplace.json | jq .

# Validate all plugin.json files
find plugins -name "plugin.json" -exec jq . {} \;