claude-skills-marketplace: Instructions file for Claude Code

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

1. engineering-workflow-skills (v1.1.0)

   • feature-planning, test-fixing, git-pushing, review-implementing
   • plan-implementer agent

2. visual-documentation-skills (v1.0.0)

   • visual-html-creator for stunning HTML documentation

3. productivity-skills (v1.0.0)

   • conversation-analyzer, code-auditor, project-bootstrapper, codebase-documenter

---

🏗️ 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!

• Skills MUST be in skills/ subdirectory at plugin root
• Skills are automatically discovered - NO listing in plugin.json
• plugin.json contains ONLY metadata (name, version, description, author)
• Same applies to agents/ and commands/ - all auto-discovered