clade-reference-architecture

# Claude Code Plugin Architecture ## Overview Claude Code has a plugin system with 4 extension points: **skills** (auto-activating knowledge), **commands** (slash commands), **agents** (specialized sub-agents), and **MCP servers** (tool providers). This skill covers building all four. ## Plugin Structure ``` my-plugin/ ├── .claude-plugin/ │ └── plugin.json # Required: name, version, description, author ├── skills/ │ └── my-skill/ │ └── SKILL.md # Auto-activating skill ├── commands/ │ └── my-command.md # Slash command (/my-command) ├── agents/ │ └── my-agent.md # Custom agent └── README.md ``` ## Building a Skill (SKILL.md) ```yaml --- name: my-skill description: | When to activate this skill. Include trigger phrases so Claude knows when to use it. Be specific about the problem it solves. allowed-tools: Read, Write, Edit, Bash(npm:*) version: 1.0.0 author: Your Name <you@example.com> license: MIT compatible-with: claude-code tags: [category, topic] --- # Skill Title ## Overview What this skill does and when to use it. ## Prerequisites - Claude Code installed - Understanding of Markdown and YAML frontmatter - For MCP servers: Node.js 18+ and `@modelcontextprotocol/sdk` ## Instructions Step-by-step instructions Claude follows when this skill activates. ### Step 1: Do the thing Explain what to do with code examples. ## Output What the user should expect when this skill runs. ## Error Handling | Error | Cause | Soluti...