mhattingpete

Claude Code Instructions for Skills Marketplace Development

Development community intermediate

SOURCE https://github.com/mhattingpete/claude-skills-marketplace

Description

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

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

Repository README

This is the README for mhattingpete/claude-skills-marketplace, shared by 7 entries in this directory. It describes the repository, not this entry specifically.

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

**engineering-workflow-skills** (v1.1.0)
- feature-planning, test-fixing, git-pushing, review-implementing
- plan-implementer agent
**visual-documentation-skills** (v1.0.0)
- visual-html-creator for stunning HTML documentation
**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

**Directory purposes:**

skills/ - All skills (auto-discovered from SKILL.md files)
agents/ - All agents (auto-discovered from AGENT.md files)
commands/ - All commands (auto-discovered from .md files)
references/ - Markdown documentation, guides, best practices
scripts/ - Executable scripts (Python, shell, etc.) that skills can use

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:**

ONLY metadata - name, version, description, author
NO skills array - skills