claude-code-plugins-dev: 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 marketplace for custom Claude Code plugins, skills, and other extensions. The repository follows a structured plugin system where each plugin is self-contained with its own metadata and skills.

Official Documentation

For detailed information about Claude Code plugins, refer to these official documentation resources:

1. Plugins: Core concepts and guide for creating and using Claude Code plugins
2. Plugins Reference: Technical reference for plugin structure, metadata schemas, and command formats
3. Plugin Marketplaces: Guide for creating and managing plugin marketplaces like this repository

These documentation resources provide authoritative information on plugin development best practices, metadata schemas, and marketplace structure that should be consulted when developing new plugins.

Architecture

Marketplace Structure

The repository uses a two-level metadata system:

1. Root marketplace manifest (.claude-plugin/marketplace.json): Central registry that defines:

   • Marketplace owner and metadata
   • List of all available plugins with their source paths, descriptions, and categories
   • Plugin root directory location (./plugins)

2. Individual plugin manifests (plugins/{plugin-name}/.claude-plugin/plugin.json): Each plugin has its own metadata including name, version, description, author, and license.

Plugin Organization

Plugins are organized under the plugins/ directory:

plugins/
  {plugin-name}/
    .claude-plugin/
      plugin.json          # Plugin metadata
    skills/
      {skill-name}/
        SKILL.md            # Skill implementation
    agents/                 # Optional
      {agent-name}.md       # Subagent definition