This document provides a comprehensive technical overview of Claude Code's official plugin ecosystem, including the plugin categorization system, metadata structure, and plugin distribution mechanism. Individual plugins and their implementation details are documented in dedicated sub-pages.
For plugin architecture internals (discovery paths, hot-reloading, scope hierarchy), see Plugin System. For marketplace structure and distribution, see Plugin Marketplace & Discovery. For specific plugin documentation, see sections 4.2 through 4.7.
Claude Code ships with 13 official plugins bundled in the repository under .claude-plugin/plugins/. These plugins are registered in .claude-plugin/marketplace.json1-150 and distributed across four functional categories. The plugin system enables extending Claude Code's capabilities through multiple extension points: skills (SKILL.md files), hooks (lifecycle interception), custom commands (slash commands), specialized agents, and MCP server integrations.
Plugin Categories:
| Category | Count | Primary Use Case |
|---|---|---|
| Development | 6 | Software architecture, feature implementation, SDK work, frontend design |
| Productivity | 4 | Git workflows, code review, custom automation |
| Learning | 2 | Educational output styles, interactive learning modes |
| Security | 1 | Security warnings and guidance |
All plugins follow a standardized directory structure with a plugin.json manifest and may contain any combination of extension mechanisms (skills, hooks, commands, agents, MCP servers).
Sources: .claude-plugin/marketplace.json1-150
The central registry at .claude-plugin/marketplace.json defines all bundled plugins with standardized metadata:
Marketplace Root Schema .claude-plugin/marketplace.json2-9:
$schema: JSON Schema reference for validationname: Marketplace identifier ("claude-code-plugins")version: Marketplace version ("1.0.0")description: Human-readable marketplace purposeowner: Anthropic contact informationPlugin Entry Schema .claude-plugin/marketplace.json11-148:
name: Plugin identifier used for installation and referencingdescription: Brief functional summary displayed in UIsource: Relative path to plugin directory (e.g., "./plugins/agent-sdk-dev")category: One of "development", "productivity", "learning", "security"version: Semantic version string (optional)author: Object with name and email fields (optional)Sources: .claude-plugin/marketplace.json1-150
Sources: .claude-plugin/marketplace.json10-149
Each plugin directory under .claude-plugin/plugins/ may contain any combination of these extension mechanisms:
Extension Mechanism Examples:
| Plugin | Skills | Hooks | Commands | Agents | MCP Servers |
|---|---|---|---|---|---|
| frontend-design | ✓ | - | - | - | - |
| code-review | - | - | ✓ | ✓ | - |
| explanatory-output-style | - | ✓ | - | - | - |
| commit-commands | - | - | ✓ | - | - |
| plugin-dev | ✓ | - | - | - | - |
| ralph-wiggum | - | ✓ | ✓ | - | - |
Sources: .claude-plugin/marketplace.json1-150
Skills are defined in SKILL.md files and provide domain expertise through specialized prompts. The system automatically discovers and loads skills from plugins/*/skills/*/SKILL.md paths.
Example: frontend-design Skill plugins/frontend-design/skills/frontend-design/SKILL.md1-42
The skill provides:
name: Identifier for skill reference (frontend-design)description: Trigger conditions for automatic activationKey characteristics:
Sources: plugins/frontend-design/skills/frontend-design/SKILL.md1-42 plugins/frontend-design/README.md1-32
Hooks intercept lifecycle events (SessionStart, PreToolUse, PostToolUse, Stop, TeammateIdle, TaskCompleted) to inject custom behavior. See Hook System for hook lifecycle details.
Common Hook Patterns:
Sources: .claude-plugin/marketplace.json51-104 .claude-plugin/marketplace.json139-147
Custom slash commands extend the CLI with domain-specific workflows. Commands are registered through plugin manifests and accessible via /command-name syntax.
Example Commands:
| Plugin | Commands | Purpose |
|---|---|---|
| commit-commands | /commit, /push, /pr | Git workflow automation |
| code-review | /code-review | Multi-agent PR review |
| ralph-wiggum | /ralph-loop | Iterative self-referential loops |
Sources: .claude-plugin/marketplace.json40-48 .claude-plugin/marketplace.json29-37 .claude-plugin/marketplace.json128-136
Plugins can define specialized agents with custom system prompts, model configurations, and tool access. Agents are spawned via the Task tool or dedicated commands.
Multi-Agent Examples:
Sources: .claude-plugin/marketplace.json29-37 .claude-plugin/marketplace.json62-70 .claude-plugin/marketplace.json117-125
Discovery Paths (by precedence):
.claude/plugins/ (highest priority)~/.claude/plugins/.claude-plugin/plugins/ (bundled with installation)Hot-Reloading Support:
Plugins support runtime hot-reloading for development workflows. Changes to SKILL.md files are detected and reloaded without restarting Claude Code. See Skill System for hot-reload implementation details.
Sources: .claude-plugin/marketplace.json1-150
| Plugin | Primary Mechanism | Description |
|---|---|---|
| agent-sdk-dev | Commands | Development kit for Claude Agent SDK .claude-plugin/marketplace.json12-15 |
| claude-opus-4-5-migration | Skills | Migration guidance from Sonnet 4.x/Opus 4.1 to Opus 4.5 .claude-plugin/marketplace.json18-26 |
| feature-dev | Agents | Multi-agent feature development with exploration, architecture, review .claude-plugin/marketplace.json62-70 |
| frontend-design | Skills | Production-grade frontend interfaces with aesthetic guidance .claude-plugin/marketplace.json73-81 |
| plugin-dev | Skills | 7 expert skills for creating Claude Code plugins .claude-plugin/marketplace.json106-114 |
| ralph-wiggum | Hooks + Commands | Interactive self-referential loops for iterative development .claude-plugin/marketplace.json128-136 |
For detailed documentation, see:
| Plugin | Primary Mechanism | Description |
|---|---|---|
| code-review | Commands + Agents | Multi-agent PR review with confidence scoring, false positive filtering .claude-plugin/marketplace.json29-37 |
| commit-commands | Commands | Git workflows including commit, push, PR creation .claude-plugin/marketplace.json40-48 |
| hookify | Hooks | Create custom hooks via markdown files to prevent unwanted behaviors .claude-plugin/marketplace.json84-92 |
| pr-review-toolkit | Agents | 6 specialized review agents (comments, tests, errors, types, quality, simplification) .claude-plugin/marketplace.json117-125 |
For detailed documentation, see:
| Plugin | Primary Mechanism | Description |
|---|---|---|
| explanatory-output-style | Hooks (SessionStart) | Educational insights about implementation choices and patterns .claude-plugin/marketplace.json51-59 |
| learning-output-style | Hooks (SessionStart) | Interactive learning mode requesting user code contributions .claude-plugin/marketplace.json95-103 |
Both plugins mimic deprecated built-in output styles, now reimplemented as plugins. See Output Style Plugins for implementation details.
| Plugin | Primary Mechanism | Description |
|---|---|---|
| security-guidance | Hooks (PreToolUse) | Security warnings for file edits (command injection, XSS, unsafe patterns) .claude-plugin/marketplace.json139-147 |
Intercepts file write operations to inject security considerations before execution. See Other Marketplace Plugins for implementation details.
Sources: .claude-plugin/marketplace.json1-150
All official plugins include authorship information for maintenance and support:
All authors use @anthropic.com email addresses. Generic plugins (agent-sdk-dev, commit-commands, pr-review-toolkit) are attributed to "Anthropic" with [email protected] contact.
Sources: .claude-plugin/marketplace.json21-145
Most plugins include semantic versioning:
| Version | Plugin Count | Plugins |
|---|---|---|
| 1.0.0 | 10 | code-review, commit-commands, explanatory-output-style, feature-dev, frontend-design, learning-output-style, pr-review-toolkit, ralph-wiggum, security-guidance, opus-4-5-migration |
| 0.1.0 | 2 | hookify, plugin-dev |
| Not specified | 1 | agent-sdk-dev |
Version 0.1.0 indicates experimental or beta status. Stable production plugins use 1.0.0.
Sources: .claude-plugin/marketplace.json1-150
Refresh this wiki