Claude Code Instructions for Skills Marketplace Development

Claude Code Instructions for Skills Marketplace Development

**Repository:** claude-skills-marketplace **Purpose:** Development guidelines for creating high-quality Claude Code skills and plugins

---

🎯 Repository Context

This is the **Claude Skills Marketplace** - a collection of reusable skills and plugins for Claude Code. When working in this repository, you are helping develop skills that will be used by many developers.

Current Plugins

undefined

---

🏗️ Plugin Structure Standards

Required Directory Structure

{plugin-name}-plugin/
├── .claude-plugin/
│   └── plugin.json              # REQUIRED: Plugin metadata ONLY (no skills array)
├── skills/                      # Skills directory (auto-discovered)
│   └── {skill-name}/
│       ├── SKILL.md             # REQUIRED: Skill specification
│       ├── references/          # OPTIONAL: Reference materials (markdown)
│       │   └── *.md             # Additional context/guides
│       └── scripts/             # OPTIONAL: Helper scripts
│           └── *.py             # Python scripts, shell scripts, etc.
├── agents/                      # OPTIONAL: Agents directory (auto-discovered)
│   └── {agent-name}/
│       └── AGENT.md             # Agent specification
├── commands/                    # OPTIONAL: Commands directory (auto-discovered)
│   └── {command-name}.md
├── README.md                    # REQUIRED: Plugin documentation
├── CHANGELOG.md                 # RECOMMENDED: Version history
└── EXAMPLES.md                  # RECOMMENDED: Usage examples

**CRITICAL: Skills are auto-discovered!**

undefined

**Directory purposes:**

undefined

Critical Files

1. `.claude-plugin/plugin.json`

**Location matters!** Must be in `.claude-plugin/` subdirectory, not at root.

{
  "name": "example-skills",
  "version": "1.0.0",
  "description": "Clear, concise description of what the plugin provides",
  "author": {
    "name": "author-name"
  }
}

**Key points:**

undefined