claude-plugins: 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. All changes must maintain compatibility with the Claude Code plugin marketplace specification.

Required Marketplace Structure

Root Directory Requirements

MUST HAVE:

• .claude-plugin/marketplace.json - Marketplace manifest (required at repository root)

Marketplace Manifest Schema (marketplace.json)

Required fields:

{
  "name": "string", // Kebab-case identifier, no spaces
  "owner": {
    "name": "string" // Maintainer name
  },
  "plugins": [] // Array of plugin entries
}

Optional fields:

• description: Brief marketplace overview
• version: Semantic version
• metadata.pluginRoot: Base path for relative plugin sources

Plugin Entry Schema (in marketplace.json)

Required fields:

{
  "name": "string", // Kebab-case identifier, no spaces
  "source": "string|object" // Plugin location (see below)
}

Source types:

• Relative path: "./plugin-name"
• GitHub: {"source": "github", "repo": "owner/repo"}
• Git URL: {"source": "url", "url": "https://..."}

Optional fields:

• description, version, author, homepage, repository, license
• keywords, category, tags
• strict: Boolean (default: true) - controls manifest handling
• Component paths: commands, agents, skills, hooks, mcpServers

Strict mode behavior:

• strict: true (default): Plugin must have .claude-plugin/plugin.json; marketplace entry supplements it
• strict: false: Plugin's .claude-plugin/plugin.json is optional; marketplace entry serves as complete manifest

Required Plugin Structure

Plugin Directory Layout

MUST HAVE:

plugin-name/
├── .claude-plugin/
│   └── plugin.json          # Required when strict=true (default)

OPTIONAL components (at plugin root, not inside .claude-plugin/):