plugin-publishing

Plugin Publishing Knowledge

This skill provides knowledge for extracting locally installed Claude Code components and packaging them into shareable plugins for marketplace submission.

Claude Code Installation Paths

Default Locations

Component	Path	Format
Skills	~/.claude/skills/<name>/SKILL.md	Directory with SKILL.md
Agents	~/.claude/agents/<name>.md	Single markdown file
Commands	~/.claude/commands/<name>.md	Single markdown file
Settings (hooks)	~/.claude/settings.json	JSON with hooks key
MCP Servers	~/.claude/mcp.json	JSON configuration

Project-Level Locations

Projects may have local overrides in:

• .claude/skills/
• .claude/agents/
• .claude/commands/
• .claude/settings.json

Plugin Structure Requirements

A valid plugin MUST have:

<plugin-name>/
├── .claude-plugin/
│   └── plugin.json          # REQUIRED: Plugin manifest
├── README.md                 # REQUIRED: Documentation
└── [components...]           # At least one component

plugin.json Schema

{
  "name": "plugin-name",           // REQUIRED: lowercase, hyphens allowed
  "version": "1.0.0",              // REQUIRED: semver format
  "description": "What it does",   // REQUIRED: one-line description
  "author": {
    "name": "Author Name",         // REQUIRED
    "email": "[email protected]"  // Optional
  },
  "homepage": "https://...",       // Optional: documentation URL
  "repository": "https://...",     // Optional: source repo
  "license": "MIT",                // Recommended
  "keywords": ["tag1", "tag2"],    // Recommended: for discovery
  "category": "development",       // One of: devops, development, security, testing, documentation, utilities
  "dependencies": {},              // Optional: other plugins required
  "commands": "./commands/",       // Path if plugin has commands
  "agents": "./agents/",           // Path if plugin has agents
  "skills": "./skills/",           // Path if plugin has skills
  "hooks": "./hooks/hooks.json",   // Path if plugin has hooks
  "mcpServers": "./.mcp.json"      // Path if plugin has MCP servers
}