[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-anthropic-plugin-structure":3,"mdc--bpokmn-key":34,"related-repo-anthropic-plugin-structure":3673,"related-org-anthropic-plugin-structure":3776},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":12,"stars":20,"repoUrl":21,"updatedAt":22,"license":23,"forks":24,"topics":25,"repo":29,"sourceUrl":32,"mdContent":33},"plugin-structure","scaffold and organize plugin structures","This skill should be used when the user asks to \"create a plugin\", \"scaffold a plugin\", \"understand plugin structure\", \"organize plugin components\", \"set up plugin.json\", \"use ${CLAUDE_PLUGIN_ROOT}\", \"add commands\u002Fagents\u002Fskills\u002Fhooks\", \"configure auto-discovery\", or needs guidance on plugin directory layout, manifest configuration, component organization, file naming conventions, or Claude Code plugin architecture best practices.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},"anthropic","Anthropic","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fanthropic.png","anthropics",[13,17],{"name":14,"slug":15,"type":16},"Architecture","architecture","tag",{"name":18,"slug":19,"type":16},"Plugin Development","plugin-development",32228,"https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fclaude-plugins-official","2026-04-10T04:55:46.825229",null,3591,[26,27,28],"claude-code","mcp","skills",{"repoUrl":21,"stars":20,"forks":24,"topics":30,"description":31},[26,27,28],"Official, Anthropic-managed directory of high quality Claude Code Plugins.","https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fclaude-plugins-official\u002Ftree\u002FHEAD\u002Fplugins\u002Fplugin-dev\u002Fskills\u002Fplugin-structure","---\nname: plugin-structure\ndescription: This skill should be used when the user asks to \"create a plugin\", \"scaffold a plugin\", \"understand plugin structure\", \"organize plugin components\", \"set up plugin.json\", \"use ${CLAUDE_PLUGIN_ROOT}\", \"add commands\u002Fagents\u002Fskills\u002Fhooks\", \"configure auto-discovery\", or needs guidance on plugin directory layout, manifest configuration, component organization, file naming conventions, or Claude Code plugin architecture best practices.\nversion: 0.1.0\n---\n\n# Plugin Structure for Claude Code\n\n## Overview\n\nClaude Code plugins follow a standardized directory structure with automatic component discovery. Understanding this structure enables creating well-organized, maintainable plugins that integrate seamlessly with Claude Code.\n\n**Key concepts:**\n- Conventional directory layout for automatic discovery\n- Manifest-driven configuration in `.claude-plugin\u002Fplugin.json`\n- Component-based organization (commands, agents, skills, hooks)\n- Portable path references using `${CLAUDE_PLUGIN_ROOT}`\n- Explicit vs. auto-discovered component loading\n\n## Directory Structure\n\nEvery Claude Code plugin follows this organizational pattern:\n\n```\nplugin-name\u002F\n├── .claude-plugin\u002F\n│   └── plugin.json          # Required: Plugin manifest\n├── commands\u002F                 # Slash commands (.md files)\n├── agents\u002F                   # Subagent definitions (.md files)\n├── skills\u002F                   # Agent skills (subdirectories)\n│   └── skill-name\u002F\n│       └── SKILL.md         # Required for each skill\n├── hooks\u002F\n│   └── hooks.json           # Event handler configuration\n├── .mcp.json                # MCP server definitions\n└── scripts\u002F                 # Helper scripts and utilities\n```\n\n**Critical rules:**\n\n1. **Manifest location**: The `plugin.json` manifest MUST be in `.claude-plugin\u002F` directory\n2. **Component locations**: All component directories (commands, agents, skills, hooks) MUST be at plugin root level, NOT nested inside `.claude-plugin\u002F`\n3. **Optional components**: Only create directories for components the plugin actually uses\n4. **Naming convention**: Use kebab-case for all directory and file names\n\n## Plugin Manifest (plugin.json)\n\nThe manifest defines plugin metadata and configuration. Located at `.claude-plugin\u002Fplugin.json`:\n\n### Required Fields\n\n```json\n{\n  \"name\": \"plugin-name\"\n}\n```\n\n**Name requirements:**\n- Use kebab-case format (lowercase with hyphens)\n- Must be unique across installed plugins\n- No spaces or special characters\n- Example: `code-review-assistant`, `test-runner`, `api-docs`\n\n### Recommended Metadata\n\n```json\n{\n  \"name\": \"plugin-name\",\n  \"version\": \"1.0.0\",\n  \"description\": \"Brief explanation of plugin purpose\",\n  \"author\": {\n    \"name\": \"Author Name\",\n    \"email\": \"author@example.com\",\n    \"url\": \"https:\u002F\u002Fexample.com\"\n  },\n  \"homepage\": \"https:\u002F\u002Fdocs.example.com\",\n  \"repository\": \"https:\u002F\u002Fgithub.com\u002Fuser\u002Fplugin-name\",\n  \"license\": \"MIT\",\n  \"keywords\": [\"testing\", \"automation\", \"ci-cd\"]\n}\n```\n\n**Version format**: Follow semantic versioning (MAJOR.MINOR.PATCH)\n**Keywords**: Use for plugin discovery and categorization\n\n### Component Path Configuration\n\nSpecify custom paths for components (supplements default directories):\n\n```json\n{\n  \"name\": \"plugin-name\",\n  \"commands\": \".\u002Fcustom-commands\",\n  \"agents\": [\".\u002Fagents\", \".\u002Fspecialized-agents\"],\n  \"hooks\": \".\u002Fconfig\u002Fhooks.json\",\n  \"mcpServers\": \".\u002F.mcp.json\"\n}\n```\n\n**Important**: Custom paths supplement defaults—they don't replace them. Components in both default directories and custom paths will load.\n\n**Path rules:**\n- Must be relative to plugin root\n- Must start with `.\u002F`\n- Cannot use absolute paths\n- Support arrays for multiple locations\n\n## Component Organization\n\n### Commands\n\n**Location**: `commands\u002F` directory\n**Format**: Markdown files with YAML frontmatter\n**Auto-discovery**: All `.md` files in `commands\u002F` load automatically\n\n**Example structure**:\n```\ncommands\u002F\n├── review.md        # \u002Freview command\n├── test.md          # \u002Ftest command\n└── deploy.md        # \u002Fdeploy command\n```\n\n**File format**:\n```markdown\n---\nname: command-name\ndescription: Command description\n---\n\nCommand implementation instructions...\n```\n\n**Usage**: Commands integrate as native slash commands in Claude Code\n\n### Agents\n\n**Location**: `agents\u002F` directory\n**Format**: Markdown files with YAML frontmatter\n**Auto-discovery**: All `.md` files in `agents\u002F` load automatically\n\n**Example structure**:\n```\nagents\u002F\n├── code-reviewer.md\n├── test-generator.md\n└── refactorer.md\n```\n\n**File format**:\n```markdown\n---\ndescription: Agent role and expertise\ncapabilities:\n  - Specific task 1\n  - Specific task 2\n---\n\nDetailed agent instructions and knowledge...\n```\n\n**Usage**: Users can invoke agents manually, or Claude Code selects them automatically based on task context\n\n### Skills\n\n**Location**: `skills\u002F` directory with subdirectories per skill\n**Format**: Each skill in its own directory with `SKILL.md` file\n**Auto-discovery**: All `SKILL.md` files in skill subdirectories load automatically\n\n**Example structure**:\n```\nskills\u002F\n├── api-testing\u002F\n│   ├── SKILL.md\n│   ├── scripts\u002F\n│   │   └── test-runner.py\n│   └── references\u002F\n│       └── api-spec.md\n└── database-migrations\u002F\n    ├── SKILL.md\n    └── examples\u002F\n        └── migration-template.sql\n```\n\n**SKILL.md format**:\n```markdown\n---\nname: Skill Name\ndescription: When to use this skill\nversion: 1.0.0\n---\n\nSkill instructions and guidance...\n```\n\n**Supporting files**: Skills can include scripts, references, examples, or assets in subdirectories\n\n**Usage**: Claude Code autonomously activates skills based on task context matching the description\n\n### Hooks\n\n**Location**: `hooks\u002Fhooks.json` or inline in `plugin.json`\n**Format**: JSON configuration defining event handlers\n**Registration**: Hooks register automatically when plugin enables\n\n**Example structure**:\n```\nhooks\u002F\n├── hooks.json           # Hook configuration\n└── scripts\u002F\n    ├── validate.sh      # Hook script\n    └── check-style.sh   # Hook script\n```\n\n**Configuration format**:\n```json\n{\n  \"PreToolUse\": [{\n    \"matcher\": \"Write|Edit\",\n    \"hooks\": [{\n      \"type\": \"command\",\n      \"command\": \"bash ${CLAUDE_PLUGIN_ROOT}\u002Fhooks\u002Fscripts\u002Fvalidate.sh\",\n      \"timeout\": 30\n    }]\n  }]\n}\n```\n\n**Available events**: PreToolUse, PostToolUse, Stop, SubagentStop, SessionStart, SessionEnd, UserPromptSubmit, PreCompact, Notification\n\n**Usage**: Hooks execute automatically in response to Claude Code events\n\n### MCP Servers\n\n**Location**: `.mcp.json` at plugin root or inline in `plugin.json`\n**Format**: JSON configuration for MCP server definitions\n**Auto-start**: Servers start automatically when plugin enables\n\n**Example format**:\n```json\n{\n  \"mcpServers\": {\n    \"server-name\": {\n      \"command\": \"node\",\n      \"args\": [\"${CLAUDE_PLUGIN_ROOT}\u002Fservers\u002Fserver.js\"],\n      \"env\": {\n        \"API_KEY\": \"${API_KEY}\"\n      }\n    }\n  }\n}\n```\n\n**Usage**: MCP servers integrate seamlessly with Claude Code's tool system\n\n## Portable Path References\n\n### ${CLAUDE_PLUGIN_ROOT}\n\nUse `${CLAUDE_PLUGIN_ROOT}` environment variable for all intra-plugin path references:\n\n```json\n{\n  \"command\": \"bash ${CLAUDE_PLUGIN_ROOT}\u002Fscripts\u002Frun.sh\"\n}\n```\n\n**Why it matters**: Plugins install in different locations depending on:\n- User installation method (marketplace, local, npm)\n- Operating system conventions\n- User preferences\n\n**Where to use it**:\n- Hook command paths\n- MCP server command arguments\n- Script execution references\n- Resource file paths\n\n**Never use**:\n- Hardcoded absolute paths (`\u002FUsers\u002Fname\u002Fplugins\u002F...`)\n- Relative paths from working directory (`.\u002Fscripts\u002F...` in commands)\n- Home directory shortcuts (`~\u002Fplugins\u002F...`)\n\n### Path Resolution Rules\n\n**In manifest JSON fields** (hooks, MCP servers):\n```json\n\"command\": \"${CLAUDE_PLUGIN_ROOT}\u002Fscripts\u002Ftool.sh\"\n```\n\n**In component files** (commands, agents, skills):\n```markdown\nReference scripts at: ${CLAUDE_PLUGIN_ROOT}\u002Fscripts\u002Fhelper.py\n```\n\n**In executed scripts**:\n```bash\n#!\u002Fbin\u002Fbash\n# ${CLAUDE_PLUGIN_ROOT} available as environment variable\nsource \"${CLAUDE_PLUGIN_ROOT}\u002Flib\u002Fcommon.sh\"\n```\n\n## File Naming Conventions\n\n### Component Files\n\n**Commands**: Use kebab-case `.md` files\n- `code-review.md` → `\u002Fcode-review`\n- `run-tests.md` → `\u002Frun-tests`\n- `api-docs.md` → `\u002Fapi-docs`\n\n**Agents**: Use kebab-case `.md` files describing role\n- `test-generator.md`\n- `code-reviewer.md`\n- `performance-analyzer.md`\n\n**Skills**: Use kebab-case directory names\n- `api-testing\u002F`\n- `database-migrations\u002F`\n- `error-handling\u002F`\n\n### Supporting Files\n\n**Scripts**: Use descriptive kebab-case names with appropriate extensions\n- `validate-input.sh`\n- `generate-report.py`\n- `process-data.js`\n\n**Documentation**: Use kebab-case markdown files\n- `api-reference.md`\n- `migration-guide.md`\n- `best-practices.md`\n\n**Configuration**: Use standard names\n- `hooks.json`\n- `.mcp.json`\n- `plugin.json`\n\n## Auto-Discovery Mechanism\n\nClaude Code automatically discovers and loads components:\n\n1. **Plugin manifest**: Reads `.claude-plugin\u002Fplugin.json` when plugin enables\n2. **Commands**: Scans `commands\u002F` directory for `.md` files\n3. **Agents**: Scans `agents\u002F` directory for `.md` files\n4. **Skills**: Scans `skills\u002F` for subdirectories containing `SKILL.md`\n5. **Hooks**: Loads configuration from `hooks\u002Fhooks.json` or manifest\n6. **MCP servers**: Loads configuration from `.mcp.json` or manifest\n\n**Discovery timing**:\n- Plugin installation: Components register with Claude Code\n- Plugin enable: Components become available for use\n- No restart required: Changes take effect on next Claude Code session\n\n**Override behavior**: Custom paths in `plugin.json` supplement (not replace) default directories\n\n## Best Practices\n\n### Organization\n\n1. **Logical grouping**: Group related components together\n   - Put test-related commands, agents, and skills together\n   - Create subdirectories in `scripts\u002F` for different purposes\n\n2. **Minimal manifest**: Keep `plugin.json` lean\n   - Only specify custom paths when necessary\n   - Rely on auto-discovery for standard layouts\n   - Use inline configuration only for simple cases\n\n3. **Documentation**: Include README files\n   - Plugin root: Overall purpose and usage\n   - Component directories: Specific guidance\n   - Script directories: Usage and requirements\n\n### Naming\n\n1. **Consistency**: Use consistent naming across components\n   - If command is `test-runner`, name related agent `test-runner-agent`\n   - Match skill directory names to their purpose\n\n2. **Clarity**: Use descriptive names that indicate purpose\n   - Good: `api-integration-testing\u002F`, `code-quality-checker.md`\n   - Avoid: `utils\u002F`, `misc.md`, `temp.sh`\n\n3. **Length**: Balance brevity with clarity\n   - Commands: 2-3 words (`review-pr`, `run-ci`)\n   - Agents: Describe role clearly (`code-reviewer`, `test-generator`)\n   - Skills: Topic-focused (`error-handling`, `api-design`)\n\n### Portability\n\n1. **Always use ${CLAUDE_PLUGIN_ROOT}**: Never hardcode paths\n2. **Test on multiple systems**: Verify on macOS, Linux, Windows\n3. **Document dependencies**: List required tools and versions\n4. **Avoid system-specific features**: Use portable bash\u002FPython constructs\n\n### Maintenance\n\n1. **Version consistently**: Update version in plugin.json for releases\n2. **Deprecate gracefully**: Mark old components clearly before removal\n3. **Document breaking changes**: Note changes affecting existing users\n4. **Test thoroughly**: Verify all components work after changes\n\n## Common Patterns\n\n### Minimal Plugin\n\nSingle command with no dependencies:\n```\nmy-plugin\u002F\n├── .claude-plugin\u002F\n│   └── plugin.json    # Just name field\n└── commands\u002F\n    └── hello.md       # Single command\n```\n\n### Full-Featured Plugin\n\nComplete plugin with all component types:\n```\nmy-plugin\u002F\n├── .claude-plugin\u002F\n│   └── plugin.json\n├── commands\u002F          # User-facing commands\n├── agents\u002F            # Specialized subagents\n├── skills\u002F            # Auto-activating skills\n├── hooks\u002F             # Event handlers\n│   ├── hooks.json\n│   └── scripts\u002F\n├── .mcp.json          # External integrations\n└── scripts\u002F           # Shared utilities\n```\n\n### Skill-Focused Plugin\n\nPlugin providing only skills:\n```\nmy-plugin\u002F\n├── .claude-plugin\u002F\n│   └── plugin.json\n└── skills\u002F\n    ├── skill-one\u002F\n    │   └── SKILL.md\n    └── skill-two\u002F\n        └── SKILL.md\n```\n\n## Troubleshooting\n\n**Component not loading**:\n- Verify file is in correct directory with correct extension\n- Check YAML frontmatter syntax (commands, agents, skills)\n- Ensure skill has `SKILL.md` (not `README.md` or other name)\n- Confirm plugin is enabled in Claude Code settings\n\n**Path resolution errors**:\n- Replace all hardcoded paths with `${CLAUDE_PLUGIN_ROOT}`\n- Verify paths are relative and start with `.\u002F` in manifest\n- Check that referenced files exist at specified paths\n- Test with `echo $CLAUDE_PLUGIN_ROOT` in hook scripts\n\n**Auto-discovery not working**:\n- Confirm directories are at plugin root (not in `.claude-plugin\u002F`)\n- Check file naming follows conventions (kebab-case, correct extensions)\n- Verify custom paths in manifest are correct\n- Restart Claude Code to reload plugin configuration\n\n**Conflicts between plugins**:\n- Use unique, descriptive component names\n- Namespace commands with plugin name if needed\n- Document potential conflicts in plugin README\n- Consider command prefixes for related functionality\n\n---\n\nFor detailed examples and advanced patterns, see files in `references\u002F` and `examples\u002F` directories.\n",{"data":35,"body":37},{"name":4,"description":6,"version":36},"0.1.0",{"type":38,"children":39},"root",[40,49,56,62,71,114,120,125,137,145,210,216,228,235,305,313,357,363,835,852,858,863,1085,1095,1103,1132,1138,1143,1190,1199,1208,1217,1292,1302,1307,1344,1352,1361,1369,1459,1468,1473,1515,1523,1532,1541,1626,1636,1645,1650,1684,1692,1701,1710,1931,1941,1950,1956,1990,1999,2226,2235,2241,2246,2258,2311,2321,2339,2348,2371,2380,2421,2427,2437,2476,2486,2500,2509,2568,2574,2580,2596,2648,2663,2693,2702,2732,2738,2748,2778,2788,2818,2828,2856,2862,2867,2980,2989,3007,3024,3030,3036,3132,3138,3303,3309,3352,3358,3401,3407,3413,3418,3427,3433,3438,3447,3453,3458,3467,3473,3482,3520,3529,3572,3581,3610,3619,3642,3646,3667],{"type":41,"tag":42,"props":43,"children":45},"element","h1",{"id":44},"plugin-structure-for-claude-code",[46],{"type":47,"value":48},"text","Plugin Structure for Claude Code",{"type":41,"tag":50,"props":51,"children":53},"h2",{"id":52},"overview",[54],{"type":47,"value":55},"Overview",{"type":41,"tag":57,"props":58,"children":59},"p",{},[60],{"type":47,"value":61},"Claude Code plugins follow a standardized directory structure with automatic component discovery. Understanding this structure enables creating well-organized, maintainable plugins that integrate seamlessly with Claude Code.",{"type":41,"tag":57,"props":63,"children":64},{},[65],{"type":41,"tag":66,"props":67,"children":68},"strong",{},[69],{"type":47,"value":70},"Key concepts:",{"type":41,"tag":72,"props":73,"children":74},"ul",{},[75,81,93,98,109],{"type":41,"tag":76,"props":77,"children":78},"li",{},[79],{"type":47,"value":80},"Conventional directory layout for automatic discovery",{"type":41,"tag":76,"props":82,"children":83},{},[84,86],{"type":47,"value":85},"Manifest-driven configuration in ",{"type":41,"tag":87,"props":88,"children":90},"code",{"className":89},[],[91],{"type":47,"value":92},".claude-plugin\u002Fplugin.json",{"type":41,"tag":76,"props":94,"children":95},{},[96],{"type":47,"value":97},"Component-based organization (commands, agents, skills, hooks)",{"type":41,"tag":76,"props":99,"children":100},{},[101,103],{"type":47,"value":102},"Portable path references using ",{"type":41,"tag":87,"props":104,"children":106},{"className":105},[],[107],{"type":47,"value":108},"${CLAUDE_PLUGIN_ROOT}",{"type":41,"tag":76,"props":110,"children":111},{},[112],{"type":47,"value":113},"Explicit vs. auto-discovered component loading",{"type":41,"tag":50,"props":115,"children":117},{"id":116},"directory-structure",[118],{"type":47,"value":119},"Directory Structure",{"type":41,"tag":57,"props":121,"children":122},{},[123],{"type":47,"value":124},"Every Claude Code plugin follows this organizational pattern:",{"type":41,"tag":126,"props":127,"children":131},"pre",{"className":128,"code":130,"language":47},[129],"language-text","plugin-name\u002F\n├── .claude-plugin\u002F\n│   └── plugin.json          # Required: Plugin manifest\n├── commands\u002F                 # Slash commands (.md files)\n├── agents\u002F                   # Subagent definitions (.md files)\n├── skills\u002F                   # Agent skills (subdirectories)\n│   └── skill-name\u002F\n│       └── SKILL.md         # Required for each skill\n├── hooks\u002F\n│   └── hooks.json           # Event handler configuration\n├── .mcp.json                # MCP server definitions\n└── scripts\u002F                 # Helper scripts and utilities\n",[132],{"type":41,"tag":87,"props":133,"children":135},{"__ignoreMap":134},"",[136],{"type":47,"value":130},{"type":41,"tag":57,"props":138,"children":139},{},[140],{"type":41,"tag":66,"props":141,"children":142},{},[143],{"type":47,"value":144},"Critical rules:",{"type":41,"tag":146,"props":147,"children":148},"ol",{},[149,175,190,200],{"type":41,"tag":76,"props":150,"children":151},{},[152,157,159,165,167,173],{"type":41,"tag":66,"props":153,"children":154},{},[155],{"type":47,"value":156},"Manifest location",{"type":47,"value":158},": The ",{"type":41,"tag":87,"props":160,"children":162},{"className":161},[],[163],{"type":47,"value":164},"plugin.json",{"type":47,"value":166}," manifest MUST be in ",{"type":41,"tag":87,"props":168,"children":170},{"className":169},[],[171],{"type":47,"value":172},".claude-plugin\u002F",{"type":47,"value":174}," directory",{"type":41,"tag":76,"props":176,"children":177},{},[178,183,185],{"type":41,"tag":66,"props":179,"children":180},{},[181],{"type":47,"value":182},"Component locations",{"type":47,"value":184},": All component directories (commands, agents, skills, hooks) MUST be at plugin root level, NOT nested inside ",{"type":41,"tag":87,"props":186,"children":188},{"className":187},[],[189],{"type":47,"value":172},{"type":41,"tag":76,"props":191,"children":192},{},[193,198],{"type":41,"tag":66,"props":194,"children":195},{},[196],{"type":47,"value":197},"Optional components",{"type":47,"value":199},": Only create directories for components the plugin actually uses",{"type":41,"tag":76,"props":201,"children":202},{},[203,208],{"type":41,"tag":66,"props":204,"children":205},{},[206],{"type":47,"value":207},"Naming convention",{"type":47,"value":209},": Use kebab-case for all directory and file names",{"type":41,"tag":50,"props":211,"children":213},{"id":212},"plugin-manifest-pluginjson",[214],{"type":47,"value":215},"Plugin Manifest (plugin.json)",{"type":41,"tag":57,"props":217,"children":218},{},[219,221,226],{"type":47,"value":220},"The manifest defines plugin metadata and configuration. Located at ",{"type":41,"tag":87,"props":222,"children":224},{"className":223},[],[225],{"type":47,"value":92},{"type":47,"value":227},":",{"type":41,"tag":229,"props":230,"children":232},"h3",{"id":231},"required-fields",[233],{"type":47,"value":234},"Required Fields",{"type":41,"tag":126,"props":236,"children":240},{"className":237,"code":238,"language":239,"meta":134,"style":134},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"name\": \"plugin-name\"\n}\n","json",[241],{"type":41,"tag":87,"props":242,"children":243},{"__ignoreMap":134},[244,256,296],{"type":41,"tag":245,"props":246,"children":249},"span",{"class":247,"line":248},"line",1,[250],{"type":41,"tag":245,"props":251,"children":253},{"style":252},"--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF",[254],{"type":47,"value":255},"{\n",{"type":41,"tag":245,"props":257,"children":259},{"class":247,"line":258},2,[260,265,271,276,280,285,291],{"type":41,"tag":245,"props":261,"children":262},{"style":252},[263],{"type":47,"value":264},"  \"",{"type":41,"tag":245,"props":266,"children":268},{"style":267},"--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA",[269],{"type":47,"value":270},"name",{"type":41,"tag":245,"props":272,"children":273},{"style":252},[274],{"type":47,"value":275},"\"",{"type":41,"tag":245,"props":277,"children":278},{"style":252},[279],{"type":47,"value":227},{"type":41,"tag":245,"props":281,"children":282},{"style":252},[283],{"type":47,"value":284}," \"",{"type":41,"tag":245,"props":286,"children":288},{"style":287},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[289],{"type":47,"value":290},"plugin-name",{"type":41,"tag":245,"props":292,"children":293},{"style":252},[294],{"type":47,"value":295},"\"\n",{"type":41,"tag":245,"props":297,"children":299},{"class":247,"line":298},3,[300],{"type":41,"tag":245,"props":301,"children":302},{"style":252},[303],{"type":47,"value":304},"}\n",{"type":41,"tag":57,"props":306,"children":307},{},[308],{"type":41,"tag":66,"props":309,"children":310},{},[311],{"type":47,"value":312},"Name requirements:",{"type":41,"tag":72,"props":314,"children":315},{},[316,321,326,331],{"type":41,"tag":76,"props":317,"children":318},{},[319],{"type":47,"value":320},"Use kebab-case format (lowercase with hyphens)",{"type":41,"tag":76,"props":322,"children":323},{},[324],{"type":47,"value":325},"Must be unique across installed plugins",{"type":41,"tag":76,"props":327,"children":328},{},[329],{"type":47,"value":330},"No spaces or special characters",{"type":41,"tag":76,"props":332,"children":333},{},[334,336,342,344,350,351],{"type":47,"value":335},"Example: ",{"type":41,"tag":87,"props":337,"children":339},{"className":338},[],[340],{"type":47,"value":341},"code-review-assistant",{"type":47,"value":343},", ",{"type":41,"tag":87,"props":345,"children":347},{"className":346},[],[348],{"type":47,"value":349},"test-runner",{"type":47,"value":343},{"type":41,"tag":87,"props":352,"children":354},{"className":353},[],[355],{"type":47,"value":356},"api-docs",{"type":41,"tag":229,"props":358,"children":360},{"id":359},"recommended-metadata",[361],{"type":47,"value":362},"Recommended Metadata",{"type":41,"tag":126,"props":364,"children":366},{"className":237,"code":365,"language":239,"meta":134,"style":134},"{\n  \"name\": \"plugin-name\",\n  \"version\": \"1.0.0\",\n  \"description\": \"Brief explanation of plugin purpose\",\n  \"author\": {\n    \"name\": \"Author Name\",\n    \"email\": \"author@example.com\",\n    \"url\": \"https:\u002F\u002Fexample.com\"\n  },\n  \"homepage\": \"https:\u002F\u002Fdocs.example.com\",\n  \"repository\": \"https:\u002F\u002Fgithub.com\u002Fuser\u002Fplugin-name\",\n  \"license\": \"MIT\",\n  \"keywords\": [\"testing\", \"automation\", \"ci-cd\"]\n}\n",[367],{"type":41,"tag":87,"props":368,"children":369},{"__ignoreMap":134},[370,377,413,450,488,514,553,591,625,634,672,710,748,827],{"type":41,"tag":245,"props":371,"children":372},{"class":247,"line":248},[373],{"type":41,"tag":245,"props":374,"children":375},{"style":252},[376],{"type":47,"value":255},{"type":41,"tag":245,"props":378,"children":379},{"class":247,"line":258},[380,384,388,392,396,400,404,408],{"type":41,"tag":245,"props":381,"children":382},{"style":252},[383],{"type":47,"value":264},{"type":41,"tag":245,"props":385,"children":386},{"style":267},[387],{"type":47,"value":270},{"type":41,"tag":245,"props":389,"children":390},{"style":252},[391],{"type":47,"value":275},{"type":41,"tag":245,"props":393,"children":394},{"style":252},[395],{"type":47,"value":227},{"type":41,"tag":245,"props":397,"children":398},{"style":252},[399],{"type":47,"value":284},{"type":41,"tag":245,"props":401,"children":402},{"style":287},[403],{"type":47,"value":290},{"type":41,"tag":245,"props":405,"children":406},{"style":252},[407],{"type":47,"value":275},{"type":41,"tag":245,"props":409,"children":410},{"style":252},[411],{"type":47,"value":412},",\n",{"type":41,"tag":245,"props":414,"children":415},{"class":247,"line":298},[416,420,425,429,433,437,442,446],{"type":41,"tag":245,"props":417,"children":418},{"style":252},[419],{"type":47,"value":264},{"type":41,"tag":245,"props":421,"children":422},{"style":267},[423],{"type":47,"value":424},"version",{"type":41,"tag":245,"props":426,"children":427},{"style":252},[428],{"type":47,"value":275},{"type":41,"tag":245,"props":430,"children":431},{"style":252},[432],{"type":47,"value":227},{"type":41,"tag":245,"props":434,"children":435},{"style":252},[436],{"type":47,"value":284},{"type":41,"tag":245,"props":438,"children":439},{"style":287},[440],{"type":47,"value":441},"1.0.0",{"type":41,"tag":245,"props":443,"children":444},{"style":252},[445],{"type":47,"value":275},{"type":41,"tag":245,"props":447,"children":448},{"style":252},[449],{"type":47,"value":412},{"type":41,"tag":245,"props":451,"children":453},{"class":247,"line":452},4,[454,458,463,467,471,475,480,484],{"type":41,"tag":245,"props":455,"children":456},{"style":252},[457],{"type":47,"value":264},{"type":41,"tag":245,"props":459,"children":460},{"style":267},[461],{"type":47,"value":462},"description",{"type":41,"tag":245,"props":464,"children":465},{"style":252},[466],{"type":47,"value":275},{"type":41,"tag":245,"props":468,"children":469},{"style":252},[470],{"type":47,"value":227},{"type":41,"tag":245,"props":472,"children":473},{"style":252},[474],{"type":47,"value":284},{"type":41,"tag":245,"props":476,"children":477},{"style":287},[478],{"type":47,"value":479},"Brief explanation of plugin purpose",{"type":41,"tag":245,"props":481,"children":482},{"style":252},[483],{"type":47,"value":275},{"type":41,"tag":245,"props":485,"children":486},{"style":252},[487],{"type":47,"value":412},{"type":41,"tag":245,"props":489,"children":491},{"class":247,"line":490},5,[492,496,501,505,509],{"type":41,"tag":245,"props":493,"children":494},{"style":252},[495],{"type":47,"value":264},{"type":41,"tag":245,"props":497,"children":498},{"style":267},[499],{"type":47,"value":500},"author",{"type":41,"tag":245,"props":502,"children":503},{"style":252},[504],{"type":47,"value":275},{"type":41,"tag":245,"props":506,"children":507},{"style":252},[508],{"type":47,"value":227},{"type":41,"tag":245,"props":510,"children":511},{"style":252},[512],{"type":47,"value":513}," {\n",{"type":41,"tag":245,"props":515,"children":517},{"class":247,"line":516},6,[518,523,528,532,536,540,545,549],{"type":41,"tag":245,"props":519,"children":520},{"style":252},[521],{"type":47,"value":522},"    \"",{"type":41,"tag":245,"props":524,"children":526},{"style":525},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[527],{"type":47,"value":270},{"type":41,"tag":245,"props":529,"children":530},{"style":252},[531],{"type":47,"value":275},{"type":41,"tag":245,"props":533,"children":534},{"style":252},[535],{"type":47,"value":227},{"type":41,"tag":245,"props":537,"children":538},{"style":252},[539],{"type":47,"value":284},{"type":41,"tag":245,"props":541,"children":542},{"style":287},[543],{"type":47,"value":544},"Author Name",{"type":41,"tag":245,"props":546,"children":547},{"style":252},[548],{"type":47,"value":275},{"type":41,"tag":245,"props":550,"children":551},{"style":252},[552],{"type":47,"value":412},{"type":41,"tag":245,"props":554,"children":556},{"class":247,"line":555},7,[557,561,566,570,574,578,583,587],{"type":41,"tag":245,"props":558,"children":559},{"style":252},[560],{"type":47,"value":522},{"type":41,"tag":245,"props":562,"children":563},{"style":525},[564],{"type":47,"value":565},"email",{"type":41,"tag":245,"props":567,"children":568},{"style":252},[569],{"type":47,"value":275},{"type":41,"tag":245,"props":571,"children":572},{"style":252},[573],{"type":47,"value":227},{"type":41,"tag":245,"props":575,"children":576},{"style":252},[577],{"type":47,"value":284},{"type":41,"tag":245,"props":579,"children":580},{"style":287},[581],{"type":47,"value":582},"author@example.com",{"type":41,"tag":245,"props":584,"children":585},{"style":252},[586],{"type":47,"value":275},{"type":41,"tag":245,"props":588,"children":589},{"style":252},[590],{"type":47,"value":412},{"type":41,"tag":245,"props":592,"children":594},{"class":247,"line":593},8,[595,599,604,608,612,616,621],{"type":41,"tag":245,"props":596,"children":597},{"style":252},[598],{"type":47,"value":522},{"type":41,"tag":245,"props":600,"children":601},{"style":525},[602],{"type":47,"value":603},"url",{"type":41,"tag":245,"props":605,"children":606},{"style":252},[607],{"type":47,"value":275},{"type":41,"tag":245,"props":609,"children":610},{"style":252},[611],{"type":47,"value":227},{"type":41,"tag":245,"props":613,"children":614},{"style":252},[615],{"type":47,"value":284},{"type":41,"tag":245,"props":617,"children":618},{"style":287},[619],{"type":47,"value":620},"https:\u002F\u002Fexample.com",{"type":41,"tag":245,"props":622,"children":623},{"style":252},[624],{"type":47,"value":295},{"type":41,"tag":245,"props":626,"children":628},{"class":247,"line":627},9,[629],{"type":41,"tag":245,"props":630,"children":631},{"style":252},[632],{"type":47,"value":633},"  },\n",{"type":41,"tag":245,"props":635,"children":637},{"class":247,"line":636},10,[638,642,647,651,655,659,664,668],{"type":41,"tag":245,"props":639,"children":640},{"style":252},[641],{"type":47,"value":264},{"type":41,"tag":245,"props":643,"children":644},{"style":267},[645],{"type":47,"value":646},"homepage",{"type":41,"tag":245,"props":648,"children":649},{"style":252},[650],{"type":47,"value":275},{"type":41,"tag":245,"props":652,"children":653},{"style":252},[654],{"type":47,"value":227},{"type":41,"tag":245,"props":656,"children":657},{"style":252},[658],{"type":47,"value":284},{"type":41,"tag":245,"props":660,"children":661},{"style":287},[662],{"type":47,"value":663},"https:\u002F\u002Fdocs.example.com",{"type":41,"tag":245,"props":665,"children":666},{"style":252},[667],{"type":47,"value":275},{"type":41,"tag":245,"props":669,"children":670},{"style":252},[671],{"type":47,"value":412},{"type":41,"tag":245,"props":673,"children":675},{"class":247,"line":674},11,[676,680,685,689,693,697,702,706],{"type":41,"tag":245,"props":677,"children":678},{"style":252},[679],{"type":47,"value":264},{"type":41,"tag":245,"props":681,"children":682},{"style":267},[683],{"type":47,"value":684},"repository",{"type":41,"tag":245,"props":686,"children":687},{"style":252},[688],{"type":47,"value":275},{"type":41,"tag":245,"props":690,"children":691},{"style":252},[692],{"type":47,"value":227},{"type":41,"tag":245,"props":694,"children":695},{"style":252},[696],{"type":47,"value":284},{"type":41,"tag":245,"props":698,"children":699},{"style":287},[700],{"type":47,"value":701},"https:\u002F\u002Fgithub.com\u002Fuser\u002Fplugin-name",{"type":41,"tag":245,"props":703,"children":704},{"style":252},[705],{"type":47,"value":275},{"type":41,"tag":245,"props":707,"children":708},{"style":252},[709],{"type":47,"value":412},{"type":41,"tag":245,"props":711,"children":713},{"class":247,"line":712},12,[714,718,723,727,731,735,740,744],{"type":41,"tag":245,"props":715,"children":716},{"style":252},[717],{"type":47,"value":264},{"type":41,"tag":245,"props":719,"children":720},{"style":267},[721],{"type":47,"value":722},"license",{"type":41,"tag":245,"props":724,"children":725},{"style":252},[726],{"type":47,"value":275},{"type":41,"tag":245,"props":728,"children":729},{"style":252},[730],{"type":47,"value":227},{"type":41,"tag":245,"props":732,"children":733},{"style":252},[734],{"type":47,"value":284},{"type":41,"tag":245,"props":736,"children":737},{"style":287},[738],{"type":47,"value":739},"MIT",{"type":41,"tag":245,"props":741,"children":742},{"style":252},[743],{"type":47,"value":275},{"type":41,"tag":245,"props":745,"children":746},{"style":252},[747],{"type":47,"value":412},{"type":41,"tag":245,"props":749,"children":751},{"class":247,"line":750},13,[752,756,761,765,769,774,778,783,787,792,796,801,805,809,813,818,822],{"type":41,"tag":245,"props":753,"children":754},{"style":252},[755],{"type":47,"value":264},{"type":41,"tag":245,"props":757,"children":758},{"style":267},[759],{"type":47,"value":760},"keywords",{"type":41,"tag":245,"props":762,"children":763},{"style":252},[764],{"type":47,"value":275},{"type":41,"tag":245,"props":766,"children":767},{"style":252},[768],{"type":47,"value":227},{"type":41,"tag":245,"props":770,"children":771},{"style":252},[772],{"type":47,"value":773}," [",{"type":41,"tag":245,"props":775,"children":776},{"style":252},[777],{"type":47,"value":275},{"type":41,"tag":245,"props":779,"children":780},{"style":287},[781],{"type":47,"value":782},"testing",{"type":41,"tag":245,"props":784,"children":785},{"style":252},[786],{"type":47,"value":275},{"type":41,"tag":245,"props":788,"children":789},{"style":252},[790],{"type":47,"value":791},",",{"type":41,"tag":245,"props":793,"children":794},{"style":252},[795],{"type":47,"value":284},{"type":41,"tag":245,"props":797,"children":798},{"style":287},[799],{"type":47,"value":800},"automation",{"type":41,"tag":245,"props":802,"children":803},{"style":252},[804],{"type":47,"value":275},{"type":41,"tag":245,"props":806,"children":807},{"style":252},[808],{"type":47,"value":791},{"type":41,"tag":245,"props":810,"children":811},{"style":252},[812],{"type":47,"value":284},{"type":41,"tag":245,"props":814,"children":815},{"style":287},[816],{"type":47,"value":817},"ci-cd",{"type":41,"tag":245,"props":819,"children":820},{"style":252},[821],{"type":47,"value":275},{"type":41,"tag":245,"props":823,"children":824},{"style":252},[825],{"type":47,"value":826},"]\n",{"type":41,"tag":245,"props":828,"children":830},{"class":247,"line":829},14,[831],{"type":41,"tag":245,"props":832,"children":833},{"style":252},[834],{"type":47,"value":304},{"type":41,"tag":57,"props":836,"children":837},{},[838,843,845,850],{"type":41,"tag":66,"props":839,"children":840},{},[841],{"type":47,"value":842},"Version format",{"type":47,"value":844},": Follow semantic versioning (MAJOR.MINOR.PATCH)\n",{"type":41,"tag":66,"props":846,"children":847},{},[848],{"type":47,"value":849},"Keywords",{"type":47,"value":851},": Use for plugin discovery and categorization",{"type":41,"tag":229,"props":853,"children":855},{"id":854},"component-path-configuration",[856],{"type":47,"value":857},"Component Path Configuration",{"type":41,"tag":57,"props":859,"children":860},{},[861],{"type":47,"value":862},"Specify custom paths for components (supplements default directories):",{"type":41,"tag":126,"props":864,"children":866},{"className":237,"code":865,"language":239,"meta":134,"style":134},"{\n  \"name\": \"plugin-name\",\n  \"commands\": \".\u002Fcustom-commands\",\n  \"agents\": [\".\u002Fagents\", \".\u002Fspecialized-agents\"],\n  \"hooks\": \".\u002Fconfig\u002Fhooks.json\",\n  \"mcpServers\": \".\u002F.mcp.json\"\n}\n",[867],{"type":41,"tag":87,"props":868,"children":869},{"__ignoreMap":134},[870,877,912,949,1008,1045,1078],{"type":41,"tag":245,"props":871,"children":872},{"class":247,"line":248},[873],{"type":41,"tag":245,"props":874,"children":875},{"style":252},[876],{"type":47,"value":255},{"type":41,"tag":245,"props":878,"children":879},{"class":247,"line":258},[880,884,888,892,896,900,904,908],{"type":41,"tag":245,"props":881,"children":882},{"style":252},[883],{"type":47,"value":264},{"type":41,"tag":245,"props":885,"children":886},{"style":267},[887],{"type":47,"value":270},{"type":41,"tag":245,"props":889,"children":890},{"style":252},[891],{"type":47,"value":275},{"type":41,"tag":245,"props":893,"children":894},{"style":252},[895],{"type":47,"value":227},{"type":41,"tag":245,"props":897,"children":898},{"style":252},[899],{"type":47,"value":284},{"type":41,"tag":245,"props":901,"children":902},{"style":287},[903],{"type":47,"value":290},{"type":41,"tag":245,"props":905,"children":906},{"style":252},[907],{"type":47,"value":275},{"type":41,"tag":245,"props":909,"children":910},{"style":252},[911],{"type":47,"value":412},{"type":41,"tag":245,"props":913,"children":914},{"class":247,"line":298},[915,919,924,928,932,936,941,945],{"type":41,"tag":245,"props":916,"children":917},{"style":252},[918],{"type":47,"value":264},{"type":41,"tag":245,"props":920,"children":921},{"style":267},[922],{"type":47,"value":923},"commands",{"type":41,"tag":245,"props":925,"children":926},{"style":252},[927],{"type":47,"value":275},{"type":41,"tag":245,"props":929,"children":930},{"style":252},[931],{"type":47,"value":227},{"type":41,"tag":245,"props":933,"children":934},{"style":252},[935],{"type":47,"value":284},{"type":41,"tag":245,"props":937,"children":938},{"style":287},[939],{"type":47,"value":940},".\u002Fcustom-commands",{"type":41,"tag":245,"props":942,"children":943},{"style":252},[944],{"type":47,"value":275},{"type":41,"tag":245,"props":946,"children":947},{"style":252},[948],{"type":47,"value":412},{"type":41,"tag":245,"props":950,"children":951},{"class":247,"line":452},[952,956,961,965,969,973,977,982,986,990,994,999,1003],{"type":41,"tag":245,"props":953,"children":954},{"style":252},[955],{"type":47,"value":264},{"type":41,"tag":245,"props":957,"children":958},{"style":267},[959],{"type":47,"value":960},"agents",{"type":41,"tag":245,"props":962,"children":963},{"style":252},[964],{"type":47,"value":275},{"type":41,"tag":245,"props":966,"children":967},{"style":252},[968],{"type":47,"value":227},{"type":41,"tag":245,"props":970,"children":971},{"style":252},[972],{"type":47,"value":773},{"type":41,"tag":245,"props":974,"children":975},{"style":252},[976],{"type":47,"value":275},{"type":41,"tag":245,"props":978,"children":979},{"style":287},[980],{"type":47,"value":981},".\u002Fagents",{"type":41,"tag":245,"props":983,"children":984},{"style":252},[985],{"type":47,"value":275},{"type":41,"tag":245,"props":987,"children":988},{"style":252},[989],{"type":47,"value":791},{"type":41,"tag":245,"props":991,"children":992},{"style":252},[993],{"type":47,"value":284},{"type":41,"tag":245,"props":995,"children":996},{"style":287},[997],{"type":47,"value":998},".\u002Fspecialized-agents",{"type":41,"tag":245,"props":1000,"children":1001},{"style":252},[1002],{"type":47,"value":275},{"type":41,"tag":245,"props":1004,"children":1005},{"style":252},[1006],{"type":47,"value":1007},"],\n",{"type":41,"tag":245,"props":1009,"children":1010},{"class":247,"line":490},[1011,1015,1020,1024,1028,1032,1037,1041],{"type":41,"tag":245,"props":1012,"children":1013},{"style":252},[1014],{"type":47,"value":264},{"type":41,"tag":245,"props":1016,"children":1017},{"style":267},[1018],{"type":47,"value":1019},"hooks",{"type":41,"tag":245,"props":1021,"children":1022},{"style":252},[1023],{"type":47,"value":275},{"type":41,"tag":245,"props":1025,"children":1026},{"style":252},[1027],{"type":47,"value":227},{"type":41,"tag":245,"props":1029,"children":1030},{"style":252},[1031],{"type":47,"value":284},{"type":41,"tag":245,"props":1033,"children":1034},{"style":287},[1035],{"type":47,"value":1036},".\u002Fconfig\u002Fhooks.json",{"type":41,"tag":245,"props":1038,"children":1039},{"style":252},[1040],{"type":47,"value":275},{"type":41,"tag":245,"props":1042,"children":1043},{"style":252},[1044],{"type":47,"value":412},{"type":41,"tag":245,"props":1046,"children":1047},{"class":247,"line":516},[1048,1052,1057,1061,1065,1069,1074],{"type":41,"tag":245,"props":1049,"children":1050},{"style":252},[1051],{"type":47,"value":264},{"type":41,"tag":245,"props":1053,"children":1054},{"style":267},[1055],{"type":47,"value":1056},"mcpServers",{"type":41,"tag":245,"props":1058,"children":1059},{"style":252},[1060],{"type":47,"value":275},{"type":41,"tag":245,"props":1062,"children":1063},{"style":252},[1064],{"type":47,"value":227},{"type":41,"tag":245,"props":1066,"children":1067},{"style":252},[1068],{"type":47,"value":284},{"type":41,"tag":245,"props":1070,"children":1071},{"style":287},[1072],{"type":47,"value":1073},".\u002F.mcp.json",{"type":41,"tag":245,"props":1075,"children":1076},{"style":252},[1077],{"type":47,"value":295},{"type":41,"tag":245,"props":1079,"children":1080},{"class":247,"line":555},[1081],{"type":41,"tag":245,"props":1082,"children":1083},{"style":252},[1084],{"type":47,"value":304},{"type":41,"tag":57,"props":1086,"children":1087},{},[1088,1093],{"type":41,"tag":66,"props":1089,"children":1090},{},[1091],{"type":47,"value":1092},"Important",{"type":47,"value":1094},": Custom paths supplement defaults—they don't replace them. Components in both default directories and custom paths will load.",{"type":41,"tag":57,"props":1096,"children":1097},{},[1098],{"type":41,"tag":66,"props":1099,"children":1100},{},[1101],{"type":47,"value":1102},"Path rules:",{"type":41,"tag":72,"props":1104,"children":1105},{},[1106,1111,1122,1127],{"type":41,"tag":76,"props":1107,"children":1108},{},[1109],{"type":47,"value":1110},"Must be relative to plugin root",{"type":41,"tag":76,"props":1112,"children":1113},{},[1114,1116],{"type":47,"value":1115},"Must start with ",{"type":41,"tag":87,"props":1117,"children":1119},{"className":1118},[],[1120],{"type":47,"value":1121},".\u002F",{"type":41,"tag":76,"props":1123,"children":1124},{},[1125],{"type":47,"value":1126},"Cannot use absolute paths",{"type":41,"tag":76,"props":1128,"children":1129},{},[1130],{"type":47,"value":1131},"Support arrays for multiple locations",{"type":41,"tag":50,"props":1133,"children":1135},{"id":1134},"component-organization",[1136],{"type":47,"value":1137},"Component Organization",{"type":41,"tag":229,"props":1139,"children":1140},{"id":923},[1141],{"type":47,"value":1142},"Commands",{"type":41,"tag":57,"props":1144,"children":1145},{},[1146,1151,1153,1159,1161,1166,1168,1173,1175,1181,1183,1188],{"type":41,"tag":66,"props":1147,"children":1148},{},[1149],{"type":47,"value":1150},"Location",{"type":47,"value":1152},": ",{"type":41,"tag":87,"props":1154,"children":1156},{"className":1155},[],[1157],{"type":47,"value":1158},"commands\u002F",{"type":47,"value":1160}," directory\n",{"type":41,"tag":66,"props":1162,"children":1163},{},[1164],{"type":47,"value":1165},"Format",{"type":47,"value":1167},": Markdown files with YAML frontmatter\n",{"type":41,"tag":66,"props":1169,"children":1170},{},[1171],{"type":47,"value":1172},"Auto-discovery",{"type":47,"value":1174},": All ",{"type":41,"tag":87,"props":1176,"children":1178},{"className":1177},[],[1179],{"type":47,"value":1180},".md",{"type":47,"value":1182}," files in ",{"type":41,"tag":87,"props":1184,"children":1186},{"className":1185},[],[1187],{"type":47,"value":1158},{"type":47,"value":1189}," load automatically",{"type":41,"tag":57,"props":1191,"children":1192},{},[1193,1198],{"type":41,"tag":66,"props":1194,"children":1195},{},[1196],{"type":47,"value":1197},"Example structure",{"type":47,"value":227},{"type":41,"tag":126,"props":1200,"children":1203},{"className":1201,"code":1202,"language":47},[129],"commands\u002F\n├── review.md        # \u002Freview command\n├── test.md          # \u002Ftest command\n└── deploy.md        # \u002Fdeploy command\n",[1204],{"type":41,"tag":87,"props":1205,"children":1206},{"__ignoreMap":134},[1207],{"type":47,"value":1202},{"type":41,"tag":57,"props":1209,"children":1210},{},[1211,1216],{"type":41,"tag":66,"props":1212,"children":1213},{},[1214],{"type":47,"value":1215},"File format",{"type":47,"value":227},{"type":41,"tag":126,"props":1218,"children":1222},{"className":1219,"code":1220,"language":1221,"meta":134,"style":134},"language-markdown shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","---\nname: command-name\ndescription: Command description\n---\n\nCommand implementation instructions...\n","markdown",[1223],{"type":41,"tag":87,"props":1224,"children":1225},{"__ignoreMap":134},[1226,1234,1251,1267,1274,1283],{"type":41,"tag":245,"props":1227,"children":1228},{"class":247,"line":248},[1229],{"type":41,"tag":245,"props":1230,"children":1231},{"style":252},[1232],{"type":47,"value":1233},"---\n",{"type":41,"tag":245,"props":1235,"children":1236},{"class":247,"line":258},[1237,1242,1246],{"type":41,"tag":245,"props":1238,"children":1240},{"style":1239},"--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178",[1241],{"type":47,"value":270},{"type":41,"tag":245,"props":1243,"children":1244},{"style":252},[1245],{"type":47,"value":227},{"type":41,"tag":245,"props":1247,"children":1248},{"style":287},[1249],{"type":47,"value":1250}," command-name\n",{"type":41,"tag":245,"props":1252,"children":1253},{"class":247,"line":298},[1254,1258,1262],{"type":41,"tag":245,"props":1255,"children":1256},{"style":1239},[1257],{"type":47,"value":462},{"type":41,"tag":245,"props":1259,"children":1260},{"style":252},[1261],{"type":47,"value":227},{"type":41,"tag":245,"props":1263,"children":1264},{"style":287},[1265],{"type":47,"value":1266}," Command description\n",{"type":41,"tag":245,"props":1268,"children":1269},{"class":247,"line":452},[1270],{"type":41,"tag":245,"props":1271,"children":1272},{"style":252},[1273],{"type":47,"value":1233},{"type":41,"tag":245,"props":1275,"children":1276},{"class":247,"line":490},[1277],{"type":41,"tag":245,"props":1278,"children":1280},{"emptyLinePlaceholder":1279},true,[1281],{"type":47,"value":1282},"\n",{"type":41,"tag":245,"props":1284,"children":1285},{"class":247,"line":516},[1286],{"type":41,"tag":245,"props":1287,"children":1289},{"style":1288},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[1290],{"type":47,"value":1291},"Command implementation instructions...\n",{"type":41,"tag":57,"props":1293,"children":1294},{},[1295,1300],{"type":41,"tag":66,"props":1296,"children":1297},{},[1298],{"type":47,"value":1299},"Usage",{"type":47,"value":1301},": Commands integrate as native slash commands in Claude Code",{"type":41,"tag":229,"props":1303,"children":1304},{"id":960},[1305],{"type":47,"value":1306},"Agents",{"type":41,"tag":57,"props":1308,"children":1309},{},[1310,1314,1315,1321,1322,1326,1327,1331,1332,1337,1338,1343],{"type":41,"tag":66,"props":1311,"children":1312},{},[1313],{"type":47,"value":1150},{"type":47,"value":1152},{"type":41,"tag":87,"props":1316,"children":1318},{"className":1317},[],[1319],{"type":47,"value":1320},"agents\u002F",{"type":47,"value":1160},{"type":41,"tag":66,"props":1323,"children":1324},{},[1325],{"type":47,"value":1165},{"type":47,"value":1167},{"type":41,"tag":66,"props":1328,"children":1329},{},[1330],{"type":47,"value":1172},{"type":47,"value":1174},{"type":41,"tag":87,"props":1333,"children":1335},{"className":1334},[],[1336],{"type":47,"value":1180},{"type":47,"value":1182},{"type":41,"tag":87,"props":1339,"children":1341},{"className":1340},[],[1342],{"type":47,"value":1320},{"type":47,"value":1189},{"type":41,"tag":57,"props":1345,"children":1346},{},[1347,1351],{"type":41,"tag":66,"props":1348,"children":1349},{},[1350],{"type":47,"value":1197},{"type":47,"value":227},{"type":41,"tag":126,"props":1353,"children":1356},{"className":1354,"code":1355,"language":47},[129],"agents\u002F\n├── code-reviewer.md\n├── test-generator.md\n└── refactorer.md\n",[1357],{"type":41,"tag":87,"props":1358,"children":1359},{"__ignoreMap":134},[1360],{"type":47,"value":1355},{"type":41,"tag":57,"props":1362,"children":1363},{},[1364,1368],{"type":41,"tag":66,"props":1365,"children":1366},{},[1367],{"type":47,"value":1215},{"type":47,"value":227},{"type":41,"tag":126,"props":1370,"children":1372},{"className":1219,"code":1371,"language":1221,"meta":134,"style":134},"---\ndescription: Agent role and expertise\ncapabilities:\n  - Specific task 1\n  - Specific task 2\n---\n\nDetailed agent instructions and knowledge...\n",[1373],{"type":41,"tag":87,"props":1374,"children":1375},{"__ignoreMap":134},[1376,1383,1399,1412,1425,1437,1444,1451],{"type":41,"tag":245,"props":1377,"children":1378},{"class":247,"line":248},[1379],{"type":41,"tag":245,"props":1380,"children":1381},{"style":252},[1382],{"type":47,"value":1233},{"type":41,"tag":245,"props":1384,"children":1385},{"class":247,"line":258},[1386,1390,1394],{"type":41,"tag":245,"props":1387,"children":1388},{"style":1239},[1389],{"type":47,"value":462},{"type":41,"tag":245,"props":1391,"children":1392},{"style":252},[1393],{"type":47,"value":227},{"type":41,"tag":245,"props":1395,"children":1396},{"style":287},[1397],{"type":47,"value":1398}," Agent role and expertise\n",{"type":41,"tag":245,"props":1400,"children":1401},{"class":247,"line":298},[1402,1407],{"type":41,"tag":245,"props":1403,"children":1404},{"style":1239},[1405],{"type":47,"value":1406},"capabilities",{"type":41,"tag":245,"props":1408,"children":1409},{"style":252},[1410],{"type":47,"value":1411},":\n",{"type":41,"tag":245,"props":1413,"children":1414},{"class":247,"line":452},[1415,1420],{"type":41,"tag":245,"props":1416,"children":1417},{"style":252},[1418],{"type":47,"value":1419},"  -",{"type":41,"tag":245,"props":1421,"children":1422},{"style":287},[1423],{"type":47,"value":1424}," Specific task 1\n",{"type":41,"tag":245,"props":1426,"children":1427},{"class":247,"line":490},[1428,1432],{"type":41,"tag":245,"props":1429,"children":1430},{"style":252},[1431],{"type":47,"value":1419},{"type":41,"tag":245,"props":1433,"children":1434},{"style":287},[1435],{"type":47,"value":1436}," Specific task 2\n",{"type":41,"tag":245,"props":1438,"children":1439},{"class":247,"line":516},[1440],{"type":41,"tag":245,"props":1441,"children":1442},{"style":252},[1443],{"type":47,"value":1233},{"type":41,"tag":245,"props":1445,"children":1446},{"class":247,"line":555},[1447],{"type":41,"tag":245,"props":1448,"children":1449},{"emptyLinePlaceholder":1279},[1450],{"type":47,"value":1282},{"type":41,"tag":245,"props":1452,"children":1453},{"class":247,"line":593},[1454],{"type":41,"tag":245,"props":1455,"children":1456},{"style":1288},[1457],{"type":47,"value":1458},"Detailed agent instructions and knowledge...\n",{"type":41,"tag":57,"props":1460,"children":1461},{},[1462,1466],{"type":41,"tag":66,"props":1463,"children":1464},{},[1465],{"type":47,"value":1299},{"type":47,"value":1467},": Users can invoke agents manually, or Claude Code selects them automatically based on task context",{"type":41,"tag":229,"props":1469,"children":1470},{"id":28},[1471],{"type":47,"value":1472},"Skills",{"type":41,"tag":57,"props":1474,"children":1475},{},[1476,1480,1481,1487,1489,1493,1495,1501,1503,1507,1508,1513],{"type":41,"tag":66,"props":1477,"children":1478},{},[1479],{"type":47,"value":1150},{"type":47,"value":1152},{"type":41,"tag":87,"props":1482,"children":1484},{"className":1483},[],[1485],{"type":47,"value":1486},"skills\u002F",{"type":47,"value":1488}," directory with subdirectories per skill\n",{"type":41,"tag":66,"props":1490,"children":1491},{},[1492],{"type":47,"value":1165},{"type":47,"value":1494},": Each skill in its own directory with ",{"type":41,"tag":87,"props":1496,"children":1498},{"className":1497},[],[1499],{"type":47,"value":1500},"SKILL.md",{"type":47,"value":1502}," file\n",{"type":41,"tag":66,"props":1504,"children":1505},{},[1506],{"type":47,"value":1172},{"type":47,"value":1174},{"type":41,"tag":87,"props":1509,"children":1511},{"className":1510},[],[1512],{"type":47,"value":1500},{"type":47,"value":1514}," files in skill subdirectories load automatically",{"type":41,"tag":57,"props":1516,"children":1517},{},[1518,1522],{"type":41,"tag":66,"props":1519,"children":1520},{},[1521],{"type":47,"value":1197},{"type":47,"value":227},{"type":41,"tag":126,"props":1524,"children":1527},{"className":1525,"code":1526,"language":47},[129],"skills\u002F\n├── api-testing\u002F\n│   ├── SKILL.md\n│   ├── scripts\u002F\n│   │   └── test-runner.py\n│   └── references\u002F\n│       └── api-spec.md\n└── database-migrations\u002F\n    ├── SKILL.md\n    └── examples\u002F\n        └── migration-template.sql\n",[1528],{"type":41,"tag":87,"props":1529,"children":1530},{"__ignoreMap":134},[1531],{"type":47,"value":1526},{"type":41,"tag":57,"props":1533,"children":1534},{},[1535,1540],{"type":41,"tag":66,"props":1536,"children":1537},{},[1538],{"type":47,"value":1539},"SKILL.md format",{"type":47,"value":227},{"type":41,"tag":126,"props":1542,"children":1544},{"className":1219,"code":1543,"language":1221,"meta":134,"style":134},"---\nname: Skill Name\ndescription: When to use this skill\nversion: 1.0.0\n---\n\nSkill instructions and guidance...\n",[1545],{"type":41,"tag":87,"props":1546,"children":1547},{"__ignoreMap":134},[1548,1555,1571,1587,1604,1611,1618],{"type":41,"tag":245,"props":1549,"children":1550},{"class":247,"line":248},[1551],{"type":41,"tag":245,"props":1552,"children":1553},{"style":252},[1554],{"type":47,"value":1233},{"type":41,"tag":245,"props":1556,"children":1557},{"class":247,"line":258},[1558,1562,1566],{"type":41,"tag":245,"props":1559,"children":1560},{"style":1239},[1561],{"type":47,"value":270},{"type":41,"tag":245,"props":1563,"children":1564},{"style":252},[1565],{"type":47,"value":227},{"type":41,"tag":245,"props":1567,"children":1568},{"style":287},[1569],{"type":47,"value":1570}," Skill Name\n",{"type":41,"tag":245,"props":1572,"children":1573},{"class":247,"line":298},[1574,1578,1582],{"type":41,"tag":245,"props":1575,"children":1576},{"style":1239},[1577],{"type":47,"value":462},{"type":41,"tag":245,"props":1579,"children":1580},{"style":252},[1581],{"type":47,"value":227},{"type":41,"tag":245,"props":1583,"children":1584},{"style":287},[1585],{"type":47,"value":1586}," When to use this skill\n",{"type":41,"tag":245,"props":1588,"children":1589},{"class":247,"line":452},[1590,1594,1598],{"type":41,"tag":245,"props":1591,"children":1592},{"style":1239},[1593],{"type":47,"value":424},{"type":41,"tag":245,"props":1595,"children":1596},{"style":252},[1597],{"type":47,"value":227},{"type":41,"tag":245,"props":1599,"children":1601},{"style":1600},"--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C",[1602],{"type":47,"value":1603}," 1.0.0\n",{"type":41,"tag":245,"props":1605,"children":1606},{"class":247,"line":490},[1607],{"type":41,"tag":245,"props":1608,"children":1609},{"style":252},[1610],{"type":47,"value":1233},{"type":41,"tag":245,"props":1612,"children":1613},{"class":247,"line":516},[1614],{"type":41,"tag":245,"props":1615,"children":1616},{"emptyLinePlaceholder":1279},[1617],{"type":47,"value":1282},{"type":41,"tag":245,"props":1619,"children":1620},{"class":247,"line":555},[1621],{"type":41,"tag":245,"props":1622,"children":1623},{"style":1288},[1624],{"type":47,"value":1625},"Skill instructions and guidance...\n",{"type":41,"tag":57,"props":1627,"children":1628},{},[1629,1634],{"type":41,"tag":66,"props":1630,"children":1631},{},[1632],{"type":47,"value":1633},"Supporting files",{"type":47,"value":1635},": Skills can include scripts, references, examples, or assets in subdirectories",{"type":41,"tag":57,"props":1637,"children":1638},{},[1639,1643],{"type":41,"tag":66,"props":1640,"children":1641},{},[1642],{"type":47,"value":1299},{"type":47,"value":1644},": Claude Code autonomously activates skills based on task context matching the description",{"type":41,"tag":229,"props":1646,"children":1647},{"id":1019},[1648],{"type":47,"value":1649},"Hooks",{"type":41,"tag":57,"props":1651,"children":1652},{},[1653,1657,1658,1664,1666,1671,1675,1677,1682],{"type":41,"tag":66,"props":1654,"children":1655},{},[1656],{"type":47,"value":1150},{"type":47,"value":1152},{"type":41,"tag":87,"props":1659,"children":1661},{"className":1660},[],[1662],{"type":47,"value":1663},"hooks\u002Fhooks.json",{"type":47,"value":1665}," or inline in ",{"type":41,"tag":87,"props":1667,"children":1669},{"className":1668},[],[1670],{"type":47,"value":164},{"type":41,"tag":66,"props":1672,"children":1673},{},[1674],{"type":47,"value":1165},{"type":47,"value":1676},": JSON configuration defining event handlers\n",{"type":41,"tag":66,"props":1678,"children":1679},{},[1680],{"type":47,"value":1681},"Registration",{"type":47,"value":1683},": Hooks register automatically when plugin enables",{"type":41,"tag":57,"props":1685,"children":1686},{},[1687,1691],{"type":41,"tag":66,"props":1688,"children":1689},{},[1690],{"type":47,"value":1197},{"type":47,"value":227},{"type":41,"tag":126,"props":1693,"children":1696},{"className":1694,"code":1695,"language":47},[129],"hooks\u002F\n├── hooks.json           # Hook configuration\n└── scripts\u002F\n    ├── validate.sh      # Hook script\n    └── check-style.sh   # Hook script\n",[1697],{"type":41,"tag":87,"props":1698,"children":1699},{"__ignoreMap":134},[1700],{"type":47,"value":1695},{"type":41,"tag":57,"props":1702,"children":1703},{},[1704,1709],{"type":41,"tag":66,"props":1705,"children":1706},{},[1707],{"type":47,"value":1708},"Configuration format",{"type":47,"value":227},{"type":41,"tag":126,"props":1711,"children":1713},{"className":237,"code":1712,"language":239,"meta":134,"style":134},"{\n  \"PreToolUse\": [{\n    \"matcher\": \"Write|Edit\",\n    \"hooks\": [{\n      \"type\": \"command\",\n      \"command\": \"bash ${CLAUDE_PLUGIN_ROOT}\u002Fhooks\u002Fscripts\u002Fvalidate.sh\",\n      \"timeout\": 30\n    }]\n  }]\n}\n",[1714],{"type":41,"tag":87,"props":1715,"children":1716},{"__ignoreMap":134},[1717,1724,1749,1786,1809,1847,1883,1908,1916,1924],{"type":41,"tag":245,"props":1718,"children":1719},{"class":247,"line":248},[1720],{"type":41,"tag":245,"props":1721,"children":1722},{"style":252},[1723],{"type":47,"value":255},{"type":41,"tag":245,"props":1725,"children":1726},{"class":247,"line":258},[1727,1731,1736,1740,1744],{"type":41,"tag":245,"props":1728,"children":1729},{"style":252},[1730],{"type":47,"value":264},{"type":41,"tag":245,"props":1732,"children":1733},{"style":267},[1734],{"type":47,"value":1735},"PreToolUse",{"type":41,"tag":245,"props":1737,"children":1738},{"style":252},[1739],{"type":47,"value":275},{"type":41,"tag":245,"props":1741,"children":1742},{"style":252},[1743],{"type":47,"value":227},{"type":41,"tag":245,"props":1745,"children":1746},{"style":252},[1747],{"type":47,"value":1748}," [{\n",{"type":41,"tag":245,"props":1750,"children":1751},{"class":247,"line":298},[1752,1756,1761,1765,1769,1773,1778,1782],{"type":41,"tag":245,"props":1753,"children":1754},{"style":252},[1755],{"type":47,"value":522},{"type":41,"tag":245,"props":1757,"children":1758},{"style":525},[1759],{"type":47,"value":1760},"matcher",{"type":41,"tag":245,"props":1762,"children":1763},{"style":252},[1764],{"type":47,"value":275},{"type":41,"tag":245,"props":1766,"children":1767},{"style":252},[1768],{"type":47,"value":227},{"type":41,"tag":245,"props":1770,"children":1771},{"style":252},[1772],{"type":47,"value":284},{"type":41,"tag":245,"props":1774,"children":1775},{"style":287},[1776],{"type":47,"value":1777},"Write|Edit",{"type":41,"tag":245,"props":1779,"children":1780},{"style":252},[1781],{"type":47,"value":275},{"type":41,"tag":245,"props":1783,"children":1784},{"style":252},[1785],{"type":47,"value":412},{"type":41,"tag":245,"props":1787,"children":1788},{"class":247,"line":452},[1789,1793,1797,1801,1805],{"type":41,"tag":245,"props":1790,"children":1791},{"style":252},[1792],{"type":47,"value":522},{"type":41,"tag":245,"props":1794,"children":1795},{"style":525},[1796],{"type":47,"value":1019},{"type":41,"tag":245,"props":1798,"children":1799},{"style":252},[1800],{"type":47,"value":275},{"type":41,"tag":245,"props":1802,"children":1803},{"style":252},[1804],{"type":47,"value":227},{"type":41,"tag":245,"props":1806,"children":1807},{"style":252},[1808],{"type":47,"value":1748},{"type":41,"tag":245,"props":1810,"children":1811},{"class":247,"line":490},[1812,1817,1822,1826,1830,1834,1839,1843],{"type":41,"tag":245,"props":1813,"children":1814},{"style":252},[1815],{"type":47,"value":1816},"      \"",{"type":41,"tag":245,"props":1818,"children":1819},{"style":1600},[1820],{"type":47,"value":1821},"type",{"type":41,"tag":245,"props":1823,"children":1824},{"style":252},[1825],{"type":47,"value":275},{"type":41,"tag":245,"props":1827,"children":1828},{"style":252},[1829],{"type":47,"value":227},{"type":41,"tag":245,"props":1831,"children":1832},{"style":252},[1833],{"type":47,"value":284},{"type":41,"tag":245,"props":1835,"children":1836},{"style":287},[1837],{"type":47,"value":1838},"command",{"type":41,"tag":245,"props":1840,"children":1841},{"style":252},[1842],{"type":47,"value":275},{"type":41,"tag":245,"props":1844,"children":1845},{"style":252},[1846],{"type":47,"value":412},{"type":41,"tag":245,"props":1848,"children":1849},{"class":247,"line":516},[1850,1854,1858,1862,1866,1870,1875,1879],{"type":41,"tag":245,"props":1851,"children":1852},{"style":252},[1853],{"type":47,"value":1816},{"type":41,"tag":245,"props":1855,"children":1856},{"style":1600},[1857],{"type":47,"value":1838},{"type":41,"tag":245,"props":1859,"children":1860},{"style":252},[1861],{"type":47,"value":275},{"type":41,"tag":245,"props":1863,"children":1864},{"style":252},[1865],{"type":47,"value":227},{"type":41,"tag":245,"props":1867,"children":1868},{"style":252},[1869],{"type":47,"value":284},{"type":41,"tag":245,"props":1871,"children":1872},{"style":287},[1873],{"type":47,"value":1874},"bash ${CLAUDE_PLUGIN_ROOT}\u002Fhooks\u002Fscripts\u002Fvalidate.sh",{"type":41,"tag":245,"props":1876,"children":1877},{"style":252},[1878],{"type":47,"value":275},{"type":41,"tag":245,"props":1880,"children":1881},{"style":252},[1882],{"type":47,"value":412},{"type":41,"tag":245,"props":1884,"children":1885},{"class":247,"line":555},[1886,1890,1895,1899,1903],{"type":41,"tag":245,"props":1887,"children":1888},{"style":252},[1889],{"type":47,"value":1816},{"type":41,"tag":245,"props":1891,"children":1892},{"style":1600},[1893],{"type":47,"value":1894},"timeout",{"type":41,"tag":245,"props":1896,"children":1897},{"style":252},[1898],{"type":47,"value":275},{"type":41,"tag":245,"props":1900,"children":1901},{"style":252},[1902],{"type":47,"value":227},{"type":41,"tag":245,"props":1904,"children":1905},{"style":1600},[1906],{"type":47,"value":1907}," 30\n",{"type":41,"tag":245,"props":1909,"children":1910},{"class":247,"line":593},[1911],{"type":41,"tag":245,"props":1912,"children":1913},{"style":252},[1914],{"type":47,"value":1915},"    }]\n",{"type":41,"tag":245,"props":1917,"children":1918},{"class":247,"line":627},[1919],{"type":41,"tag":245,"props":1920,"children":1921},{"style":252},[1922],{"type":47,"value":1923},"  }]\n",{"type":41,"tag":245,"props":1925,"children":1926},{"class":247,"line":636},[1927],{"type":41,"tag":245,"props":1928,"children":1929},{"style":252},[1930],{"type":47,"value":304},{"type":41,"tag":57,"props":1932,"children":1933},{},[1934,1939],{"type":41,"tag":66,"props":1935,"children":1936},{},[1937],{"type":47,"value":1938},"Available events",{"type":47,"value":1940},": PreToolUse, PostToolUse, Stop, SubagentStop, SessionStart, SessionEnd, UserPromptSubmit, PreCompact, Notification",{"type":41,"tag":57,"props":1942,"children":1943},{},[1944,1948],{"type":41,"tag":66,"props":1945,"children":1946},{},[1947],{"type":47,"value":1299},{"type":47,"value":1949},": Hooks execute automatically in response to Claude Code events",{"type":41,"tag":229,"props":1951,"children":1953},{"id":1952},"mcp-servers",[1954],{"type":47,"value":1955},"MCP Servers",{"type":41,"tag":57,"props":1957,"children":1958},{},[1959,1963,1964,1970,1972,1977,1981,1983,1988],{"type":41,"tag":66,"props":1960,"children":1961},{},[1962],{"type":47,"value":1150},{"type":47,"value":1152},{"type":41,"tag":87,"props":1965,"children":1967},{"className":1966},[],[1968],{"type":47,"value":1969},".mcp.json",{"type":47,"value":1971}," at plugin root or inline in ",{"type":41,"tag":87,"props":1973,"children":1975},{"className":1974},[],[1976],{"type":47,"value":164},{"type":41,"tag":66,"props":1978,"children":1979},{},[1980],{"type":47,"value":1165},{"type":47,"value":1982},": JSON configuration for MCP server definitions\n",{"type":41,"tag":66,"props":1984,"children":1985},{},[1986],{"type":47,"value":1987},"Auto-start",{"type":47,"value":1989},": Servers start automatically when plugin enables",{"type":41,"tag":57,"props":1991,"children":1992},{},[1993,1998],{"type":41,"tag":66,"props":1994,"children":1995},{},[1996],{"type":47,"value":1997},"Example format",{"type":47,"value":227},{"type":41,"tag":126,"props":2000,"children":2002},{"className":237,"code":2001,"language":239,"meta":134,"style":134},"{\n  \"mcpServers\": {\n    \"server-name\": {\n      \"command\": \"node\",\n      \"args\": [\"${CLAUDE_PLUGIN_ROOT}\u002Fservers\u002Fserver.js\"],\n      \"env\": {\n        \"API_KEY\": \"${API_KEY}\"\n      }\n    }\n  }\n}\n",[2003],{"type":41,"tag":87,"props":2004,"children":2005},{"__ignoreMap":134},[2006,2013,2036,2060,2096,2137,2161,2195,2203,2211,2219],{"type":41,"tag":245,"props":2007,"children":2008},{"class":247,"line":248},[2009],{"type":41,"tag":245,"props":2010,"children":2011},{"style":252},[2012],{"type":47,"value":255},{"type":41,"tag":245,"props":2014,"children":2015},{"class":247,"line":258},[2016,2020,2024,2028,2032],{"type":41,"tag":245,"props":2017,"children":2018},{"style":252},[2019],{"type":47,"value":264},{"type":41,"tag":245,"props":2021,"children":2022},{"style":267},[2023],{"type":47,"value":1056},{"type":41,"tag":245,"props":2025,"children":2026},{"style":252},[2027],{"type":47,"value":275},{"type":41,"tag":245,"props":2029,"children":2030},{"style":252},[2031],{"type":47,"value":227},{"type":41,"tag":245,"props":2033,"children":2034},{"style":252},[2035],{"type":47,"value":513},{"type":41,"tag":245,"props":2037,"children":2038},{"class":247,"line":298},[2039,2043,2048,2052,2056],{"type":41,"tag":245,"props":2040,"children":2041},{"style":252},[2042],{"type":47,"value":522},{"type":41,"tag":245,"props":2044,"children":2045},{"style":525},[2046],{"type":47,"value":2047},"server-name",{"type":41,"tag":245,"props":2049,"children":2050},{"style":252},[2051],{"type":47,"value":275},{"type":41,"tag":245,"props":2053,"children":2054},{"style":252},[2055],{"type":47,"value":227},{"type":41,"tag":245,"props":2057,"children":2058},{"style":252},[2059],{"type":47,"value":513},{"type":41,"tag":245,"props":2061,"children":2062},{"class":247,"line":452},[2063,2067,2071,2075,2079,2083,2088,2092],{"type":41,"tag":245,"props":2064,"children":2065},{"style":252},[2066],{"type":47,"value":1816},{"type":41,"tag":245,"props":2068,"children":2069},{"style":1600},[2070],{"type":47,"value":1838},{"type":41,"tag":245,"props":2072,"children":2073},{"style":252},[2074],{"type":47,"value":275},{"type":41,"tag":245,"props":2076,"children":2077},{"style":252},[2078],{"type":47,"value":227},{"type":41,"tag":245,"props":2080,"children":2081},{"style":252},[2082],{"type":47,"value":284},{"type":41,"tag":245,"props":2084,"children":2085},{"style":287},[2086],{"type":47,"value":2087},"node",{"type":41,"tag":245,"props":2089,"children":2090},{"style":252},[2091],{"type":47,"value":275},{"type":41,"tag":245,"props":2093,"children":2094},{"style":252},[2095],{"type":47,"value":412},{"type":41,"tag":245,"props":2097,"children":2098},{"class":247,"line":490},[2099,2103,2108,2112,2116,2120,2124,2129,2133],{"type":41,"tag":245,"props":2100,"children":2101},{"style":252},[2102],{"type":47,"value":1816},{"type":41,"tag":245,"props":2104,"children":2105},{"style":1600},[2106],{"type":47,"value":2107},"args",{"type":41,"tag":245,"props":2109,"children":2110},{"style":252},[2111],{"type":47,"value":275},{"type":41,"tag":245,"props":2113,"children":2114},{"style":252},[2115],{"type":47,"value":227},{"type":41,"tag":245,"props":2117,"children":2118},{"style":252},[2119],{"type":47,"value":773},{"type":41,"tag":245,"props":2121,"children":2122},{"style":252},[2123],{"type":47,"value":275},{"type":41,"tag":245,"props":2125,"children":2126},{"style":287},[2127],{"type":47,"value":2128},"${CLAUDE_PLUGIN_ROOT}\u002Fservers\u002Fserver.js",{"type":41,"tag":245,"props":2130,"children":2131},{"style":252},[2132],{"type":47,"value":275},{"type":41,"tag":245,"props":2134,"children":2135},{"style":252},[2136],{"type":47,"value":1007},{"type":41,"tag":245,"props":2138,"children":2139},{"class":247,"line":516},[2140,2144,2149,2153,2157],{"type":41,"tag":245,"props":2141,"children":2142},{"style":252},[2143],{"type":47,"value":1816},{"type":41,"tag":245,"props":2145,"children":2146},{"style":1600},[2147],{"type":47,"value":2148},"env",{"type":41,"tag":245,"props":2150,"children":2151},{"style":252},[2152],{"type":47,"value":275},{"type":41,"tag":245,"props":2154,"children":2155},{"style":252},[2156],{"type":47,"value":227},{"type":41,"tag":245,"props":2158,"children":2159},{"style":252},[2160],{"type":47,"value":513},{"type":41,"tag":245,"props":2162,"children":2163},{"class":247,"line":555},[2164,2169,2174,2178,2182,2186,2191],{"type":41,"tag":245,"props":2165,"children":2166},{"style":252},[2167],{"type":47,"value":2168},"        \"",{"type":41,"tag":245,"props":2170,"children":2171},{"style":1239},[2172],{"type":47,"value":2173},"API_KEY",{"type":41,"tag":245,"props":2175,"children":2176},{"style":252},[2177],{"type":47,"value":275},{"type":41,"tag":245,"props":2179,"children":2180},{"style":252},[2181],{"type":47,"value":227},{"type":41,"tag":245,"props":2183,"children":2184},{"style":252},[2185],{"type":47,"value":284},{"type":41,"tag":245,"props":2187,"children":2188},{"style":287},[2189],{"type":47,"value":2190},"${API_KEY}",{"type":41,"tag":245,"props":2192,"children":2193},{"style":252},[2194],{"type":47,"value":295},{"type":41,"tag":245,"props":2196,"children":2197},{"class":247,"line":593},[2198],{"type":41,"tag":245,"props":2199,"children":2200},{"style":252},[2201],{"type":47,"value":2202},"      }\n",{"type":41,"tag":245,"props":2204,"children":2205},{"class":247,"line":627},[2206],{"type":41,"tag":245,"props":2207,"children":2208},{"style":252},[2209],{"type":47,"value":2210},"    }\n",{"type":41,"tag":245,"props":2212,"children":2213},{"class":247,"line":636},[2214],{"type":41,"tag":245,"props":2215,"children":2216},{"style":252},[2217],{"type":47,"value":2218},"  }\n",{"type":41,"tag":245,"props":2220,"children":2221},{"class":247,"line":674},[2222],{"type":41,"tag":245,"props":2223,"children":2224},{"style":252},[2225],{"type":47,"value":304},{"type":41,"tag":57,"props":2227,"children":2228},{},[2229,2233],{"type":41,"tag":66,"props":2230,"children":2231},{},[2232],{"type":47,"value":1299},{"type":47,"value":2234},": MCP servers integrate seamlessly with Claude Code's tool system",{"type":41,"tag":50,"props":2236,"children":2238},{"id":2237},"portable-path-references",[2239],{"type":47,"value":2240},"Portable Path References",{"type":41,"tag":229,"props":2242,"children":2244},{"id":2243},"claude_plugin_root",[2245],{"type":47,"value":108},{"type":41,"tag":57,"props":2247,"children":2248},{},[2249,2251,2256],{"type":47,"value":2250},"Use ",{"type":41,"tag":87,"props":2252,"children":2254},{"className":2253},[],[2255],{"type":47,"value":108},{"type":47,"value":2257}," environment variable for all intra-plugin path references:",{"type":41,"tag":126,"props":2259,"children":2261},{"className":237,"code":2260,"language":239,"meta":134,"style":134},"{\n  \"command\": \"bash ${CLAUDE_PLUGIN_ROOT}\u002Fscripts\u002Frun.sh\"\n}\n",[2262],{"type":41,"tag":87,"props":2263,"children":2264},{"__ignoreMap":134},[2265,2272,2304],{"type":41,"tag":245,"props":2266,"children":2267},{"class":247,"line":248},[2268],{"type":41,"tag":245,"props":2269,"children":2270},{"style":252},[2271],{"type":47,"value":255},{"type":41,"tag":245,"props":2273,"children":2274},{"class":247,"line":258},[2275,2279,2283,2287,2291,2295,2300],{"type":41,"tag":245,"props":2276,"children":2277},{"style":252},[2278],{"type":47,"value":264},{"type":41,"tag":245,"props":2280,"children":2281},{"style":267},[2282],{"type":47,"value":1838},{"type":41,"tag":245,"props":2284,"children":2285},{"style":252},[2286],{"type":47,"value":275},{"type":41,"tag":245,"props":2288,"children":2289},{"style":252},[2290],{"type":47,"value":227},{"type":41,"tag":245,"props":2292,"children":2293},{"style":252},[2294],{"type":47,"value":284},{"type":41,"tag":245,"props":2296,"children":2297},{"style":287},[2298],{"type":47,"value":2299},"bash ${CLAUDE_PLUGIN_ROOT}\u002Fscripts\u002Frun.sh",{"type":41,"tag":245,"props":2301,"children":2302},{"style":252},[2303],{"type":47,"value":295},{"type":41,"tag":245,"props":2305,"children":2306},{"class":247,"line":298},[2307],{"type":41,"tag":245,"props":2308,"children":2309},{"style":252},[2310],{"type":47,"value":304},{"type":41,"tag":57,"props":2312,"children":2313},{},[2314,2319],{"type":41,"tag":66,"props":2315,"children":2316},{},[2317],{"type":47,"value":2318},"Why it matters",{"type":47,"value":2320},": Plugins install in different locations depending on:",{"type":41,"tag":72,"props":2322,"children":2323},{},[2324,2329,2334],{"type":41,"tag":76,"props":2325,"children":2326},{},[2327],{"type":47,"value":2328},"User installation method (marketplace, local, npm)",{"type":41,"tag":76,"props":2330,"children":2331},{},[2332],{"type":47,"value":2333},"Operating system conventions",{"type":41,"tag":76,"props":2335,"children":2336},{},[2337],{"type":47,"value":2338},"User preferences",{"type":41,"tag":57,"props":2340,"children":2341},{},[2342,2347],{"type":41,"tag":66,"props":2343,"children":2344},{},[2345],{"type":47,"value":2346},"Where to use it",{"type":47,"value":227},{"type":41,"tag":72,"props":2349,"children":2350},{},[2351,2356,2361,2366],{"type":41,"tag":76,"props":2352,"children":2353},{},[2354],{"type":47,"value":2355},"Hook command paths",{"type":41,"tag":76,"props":2357,"children":2358},{},[2359],{"type":47,"value":2360},"MCP server command arguments",{"type":41,"tag":76,"props":2362,"children":2363},{},[2364],{"type":47,"value":2365},"Script execution references",{"type":41,"tag":76,"props":2367,"children":2368},{},[2369],{"type":47,"value":2370},"Resource file paths",{"type":41,"tag":57,"props":2372,"children":2373},{},[2374,2379],{"type":41,"tag":66,"props":2375,"children":2376},{},[2377],{"type":47,"value":2378},"Never use",{"type":47,"value":227},{"type":41,"tag":72,"props":2381,"children":2382},{},[2383,2396,2409],{"type":41,"tag":76,"props":2384,"children":2385},{},[2386,2388,2394],{"type":47,"value":2387},"Hardcoded absolute paths (",{"type":41,"tag":87,"props":2389,"children":2391},{"className":2390},[],[2392],{"type":47,"value":2393},"\u002FUsers\u002Fname\u002Fplugins\u002F...",{"type":47,"value":2395},")",{"type":41,"tag":76,"props":2397,"children":2398},{},[2399,2401,2407],{"type":47,"value":2400},"Relative paths from working directory (",{"type":41,"tag":87,"props":2402,"children":2404},{"className":2403},[],[2405],{"type":47,"value":2406},".\u002Fscripts\u002F...",{"type":47,"value":2408}," in commands)",{"type":41,"tag":76,"props":2410,"children":2411},{},[2412,2414,2420],{"type":47,"value":2413},"Home directory shortcuts (",{"type":41,"tag":87,"props":2415,"children":2417},{"className":2416},[],[2418],{"type":47,"value":2419},"~\u002Fplugins\u002F...",{"type":47,"value":2395},{"type":41,"tag":229,"props":2422,"children":2424},{"id":2423},"path-resolution-rules",[2425],{"type":47,"value":2426},"Path Resolution Rules",{"type":41,"tag":57,"props":2428,"children":2429},{},[2430,2435],{"type":41,"tag":66,"props":2431,"children":2432},{},[2433],{"type":47,"value":2434},"In manifest JSON fields",{"type":47,"value":2436}," (hooks, MCP servers):",{"type":41,"tag":126,"props":2438,"children":2440},{"className":237,"code":2439,"language":239,"meta":134,"style":134},"\"command\": \"${CLAUDE_PLUGIN_ROOT}\u002Fscripts\u002Ftool.sh\"\n",[2441],{"type":41,"tag":87,"props":2442,"children":2443},{"__ignoreMap":134},[2444],{"type":41,"tag":245,"props":2445,"children":2446},{"class":247,"line":248},[2447,2451,2455,2459,2463,2467,2472],{"type":41,"tag":245,"props":2448,"children":2449},{"style":252},[2450],{"type":47,"value":275},{"type":41,"tag":245,"props":2452,"children":2453},{"style":287},[2454],{"type":47,"value":1838},{"type":41,"tag":245,"props":2456,"children":2457},{"style":252},[2458],{"type":47,"value":275},{"type":41,"tag":245,"props":2460,"children":2461},{"style":1288},[2462],{"type":47,"value":1152},{"type":41,"tag":245,"props":2464,"children":2465},{"style":252},[2466],{"type":47,"value":275},{"type":41,"tag":245,"props":2468,"children":2469},{"style":287},[2470],{"type":47,"value":2471},"${CLAUDE_PLUGIN_ROOT}\u002Fscripts\u002Ftool.sh",{"type":41,"tag":245,"props":2473,"children":2474},{"style":252},[2475],{"type":47,"value":295},{"type":41,"tag":57,"props":2477,"children":2478},{},[2479,2484],{"type":41,"tag":66,"props":2480,"children":2481},{},[2482],{"type":47,"value":2483},"In component files",{"type":47,"value":2485}," (commands, agents, skills):",{"type":41,"tag":126,"props":2487,"children":2489},{"className":1219,"code":2488,"language":1221,"meta":134,"style":134},"Reference scripts at: ${CLAUDE_PLUGIN_ROOT}\u002Fscripts\u002Fhelper.py\n",[2490],{"type":41,"tag":87,"props":2491,"children":2492},{"__ignoreMap":134},[2493],{"type":41,"tag":245,"props":2494,"children":2495},{"class":247,"line":248},[2496],{"type":41,"tag":245,"props":2497,"children":2498},{"style":1288},[2499],{"type":47,"value":2488},{"type":41,"tag":57,"props":2501,"children":2502},{},[2503,2508],{"type":41,"tag":66,"props":2504,"children":2505},{},[2506],{"type":47,"value":2507},"In executed scripts",{"type":47,"value":227},{"type":41,"tag":126,"props":2510,"children":2514},{"className":2511,"code":2512,"language":2513,"meta":134,"style":134},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","#!\u002Fbin\u002Fbash\n# ${CLAUDE_PLUGIN_ROOT} available as environment variable\nsource \"${CLAUDE_PLUGIN_ROOT}\u002Flib\u002Fcommon.sh\"\n","bash",[2515],{"type":41,"tag":87,"props":2516,"children":2517},{"__ignoreMap":134},[2518,2527,2535],{"type":41,"tag":245,"props":2519,"children":2520},{"class":247,"line":248},[2521],{"type":41,"tag":245,"props":2522,"children":2524},{"style":2523},"--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic",[2525],{"type":47,"value":2526},"#!\u002Fbin\u002Fbash\n",{"type":41,"tag":245,"props":2528,"children":2529},{"class":247,"line":258},[2530],{"type":41,"tag":245,"props":2531,"children":2532},{"style":2523},[2533],{"type":47,"value":2534},"# ${CLAUDE_PLUGIN_ROOT} available as environment variable\n",{"type":41,"tag":245,"props":2536,"children":2537},{"class":247,"line":298},[2538,2544,2549,2554,2559,2564],{"type":41,"tag":245,"props":2539,"children":2541},{"style":2540},"--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF",[2542],{"type":47,"value":2543},"source",{"type":41,"tag":245,"props":2545,"children":2546},{"style":252},[2547],{"type":47,"value":2548}," \"${",{"type":41,"tag":245,"props":2550,"children":2551},{"style":1288},[2552],{"type":47,"value":2553},"CLAUDE_PLUGIN_ROOT",{"type":41,"tag":245,"props":2555,"children":2556},{"style":252},[2557],{"type":47,"value":2558},"}",{"type":41,"tag":245,"props":2560,"children":2561},{"style":287},[2562],{"type":47,"value":2563},"\u002Flib\u002Fcommon.sh",{"type":41,"tag":245,"props":2565,"children":2566},{"style":252},[2567],{"type":47,"value":295},{"type":41,"tag":50,"props":2569,"children":2571},{"id":2570},"file-naming-conventions",[2572],{"type":47,"value":2573},"File Naming Conventions",{"type":41,"tag":229,"props":2575,"children":2577},{"id":2576},"component-files",[2578],{"type":47,"value":2579},"Component Files",{"type":41,"tag":57,"props":2581,"children":2582},{},[2583,2587,2589,2594],{"type":41,"tag":66,"props":2584,"children":2585},{},[2586],{"type":47,"value":1142},{"type":47,"value":2588},": Use kebab-case ",{"type":41,"tag":87,"props":2590,"children":2592},{"className":2591},[],[2593],{"type":47,"value":1180},{"type":47,"value":2595}," files",{"type":41,"tag":72,"props":2597,"children":2598},{},[2599,2616,2632],{"type":41,"tag":76,"props":2600,"children":2601},{},[2602,2608,2610],{"type":41,"tag":87,"props":2603,"children":2605},{"className":2604},[],[2606],{"type":47,"value":2607},"code-review.md",{"type":47,"value":2609}," → ",{"type":41,"tag":87,"props":2611,"children":2613},{"className":2612},[],[2614],{"type":47,"value":2615},"\u002Fcode-review",{"type":41,"tag":76,"props":2617,"children":2618},{},[2619,2625,2626],{"type":41,"tag":87,"props":2620,"children":2622},{"className":2621},[],[2623],{"type":47,"value":2624},"run-tests.md",{"type":47,"value":2609},{"type":41,"tag":87,"props":2627,"children":2629},{"className":2628},[],[2630],{"type":47,"value":2631},"\u002Frun-tests",{"type":41,"tag":76,"props":2633,"children":2634},{},[2635,2641,2642],{"type":41,"tag":87,"props":2636,"children":2638},{"className":2637},[],[2639],{"type":47,"value":2640},"api-docs.md",{"type":47,"value":2609},{"type":41,"tag":87,"props":2643,"children":2645},{"className":2644},[],[2646],{"type":47,"value":2647},"\u002Fapi-docs",{"type":41,"tag":57,"props":2649,"children":2650},{},[2651,2655,2656,2661],{"type":41,"tag":66,"props":2652,"children":2653},{},[2654],{"type":47,"value":1306},{"type":47,"value":2588},{"type":41,"tag":87,"props":2657,"children":2659},{"className":2658},[],[2660],{"type":47,"value":1180},{"type":47,"value":2662}," files describing role",{"type":41,"tag":72,"props":2664,"children":2665},{},[2666,2675,2684],{"type":41,"tag":76,"props":2667,"children":2668},{},[2669],{"type":41,"tag":87,"props":2670,"children":2672},{"className":2671},[],[2673],{"type":47,"value":2674},"test-generator.md",{"type":41,"tag":76,"props":2676,"children":2677},{},[2678],{"type":41,"tag":87,"props":2679,"children":2681},{"className":2680},[],[2682],{"type":47,"value":2683},"code-reviewer.md",{"type":41,"tag":76,"props":2685,"children":2686},{},[2687],{"type":41,"tag":87,"props":2688,"children":2690},{"className":2689},[],[2691],{"type":47,"value":2692},"performance-analyzer.md",{"type":41,"tag":57,"props":2694,"children":2695},{},[2696,2700],{"type":41,"tag":66,"props":2697,"children":2698},{},[2699],{"type":47,"value":1472},{"type":47,"value":2701},": Use kebab-case directory names",{"type":41,"tag":72,"props":2703,"children":2704},{},[2705,2714,2723],{"type":41,"tag":76,"props":2706,"children":2707},{},[2708],{"type":41,"tag":87,"props":2709,"children":2711},{"className":2710},[],[2712],{"type":47,"value":2713},"api-testing\u002F",{"type":41,"tag":76,"props":2715,"children":2716},{},[2717],{"type":41,"tag":87,"props":2718,"children":2720},{"className":2719},[],[2721],{"type":47,"value":2722},"database-migrations\u002F",{"type":41,"tag":76,"props":2724,"children":2725},{},[2726],{"type":41,"tag":87,"props":2727,"children":2729},{"className":2728},[],[2730],{"type":47,"value":2731},"error-handling\u002F",{"type":41,"tag":229,"props":2733,"children":2735},{"id":2734},"supporting-files",[2736],{"type":47,"value":2737},"Supporting Files",{"type":41,"tag":57,"props":2739,"children":2740},{},[2741,2746],{"type":41,"tag":66,"props":2742,"children":2743},{},[2744],{"type":47,"value":2745},"Scripts",{"type":47,"value":2747},": Use descriptive kebab-case names with appropriate extensions",{"type":41,"tag":72,"props":2749,"children":2750},{},[2751,2760,2769],{"type":41,"tag":76,"props":2752,"children":2753},{},[2754],{"type":41,"tag":87,"props":2755,"children":2757},{"className":2756},[],[2758],{"type":47,"value":2759},"validate-input.sh",{"type":41,"tag":76,"props":2761,"children":2762},{},[2763],{"type":41,"tag":87,"props":2764,"children":2766},{"className":2765},[],[2767],{"type":47,"value":2768},"generate-report.py",{"type":41,"tag":76,"props":2770,"children":2771},{},[2772],{"type":41,"tag":87,"props":2773,"children":2775},{"className":2774},[],[2776],{"type":47,"value":2777},"process-data.js",{"type":41,"tag":57,"props":2779,"children":2780},{},[2781,2786],{"type":41,"tag":66,"props":2782,"children":2783},{},[2784],{"type":47,"value":2785},"Documentation",{"type":47,"value":2787},": Use kebab-case markdown files",{"type":41,"tag":72,"props":2789,"children":2790},{},[2791,2800,2809],{"type":41,"tag":76,"props":2792,"children":2793},{},[2794],{"type":41,"tag":87,"props":2795,"children":2797},{"className":2796},[],[2798],{"type":47,"value":2799},"api-reference.md",{"type":41,"tag":76,"props":2801,"children":2802},{},[2803],{"type":41,"tag":87,"props":2804,"children":2806},{"className":2805},[],[2807],{"type":47,"value":2808},"migration-guide.md",{"type":41,"tag":76,"props":2810,"children":2811},{},[2812],{"type":41,"tag":87,"props":2813,"children":2815},{"className":2814},[],[2816],{"type":47,"value":2817},"best-practices.md",{"type":41,"tag":57,"props":2819,"children":2820},{},[2821,2826],{"type":41,"tag":66,"props":2822,"children":2823},{},[2824],{"type":47,"value":2825},"Configuration",{"type":47,"value":2827},": Use standard names",{"type":41,"tag":72,"props":2829,"children":2830},{},[2831,2840,2848],{"type":41,"tag":76,"props":2832,"children":2833},{},[2834],{"type":41,"tag":87,"props":2835,"children":2837},{"className":2836},[],[2838],{"type":47,"value":2839},"hooks.json",{"type":41,"tag":76,"props":2841,"children":2842},{},[2843],{"type":41,"tag":87,"props":2844,"children":2846},{"className":2845},[],[2847],{"type":47,"value":1969},{"type":41,"tag":76,"props":2849,"children":2850},{},[2851],{"type":41,"tag":87,"props":2852,"children":2854},{"className":2853},[],[2855],{"type":47,"value":164},{"type":41,"tag":50,"props":2857,"children":2859},{"id":2858},"auto-discovery-mechanism",[2860],{"type":47,"value":2861},"Auto-Discovery Mechanism",{"type":41,"tag":57,"props":2863,"children":2864},{},[2865],{"type":47,"value":2866},"Claude Code automatically discovers and loads components:",{"type":41,"tag":146,"props":2868,"children":2869},{},[2870,2887,2909,2929,2949,2965],{"type":41,"tag":76,"props":2871,"children":2872},{},[2873,2878,2880,2885],{"type":41,"tag":66,"props":2874,"children":2875},{},[2876],{"type":47,"value":2877},"Plugin manifest",{"type":47,"value":2879},": Reads ",{"type":41,"tag":87,"props":2881,"children":2883},{"className":2882},[],[2884],{"type":47,"value":92},{"type":47,"value":2886}," when plugin enables",{"type":41,"tag":76,"props":2888,"children":2889},{},[2890,2894,2896,2901,2903,2908],{"type":41,"tag":66,"props":2891,"children":2892},{},[2893],{"type":47,"value":1142},{"type":47,"value":2895},": Scans ",{"type":41,"tag":87,"props":2897,"children":2899},{"className":2898},[],[2900],{"type":47,"value":1158},{"type":47,"value":2902}," directory for ",{"type":41,"tag":87,"props":2904,"children":2906},{"className":2905},[],[2907],{"type":47,"value":1180},{"type":47,"value":2595},{"type":41,"tag":76,"props":2910,"children":2911},{},[2912,2916,2917,2922,2923,2928],{"type":41,"tag":66,"props":2913,"children":2914},{},[2915],{"type":47,"value":1306},{"type":47,"value":2895},{"type":41,"tag":87,"props":2918,"children":2920},{"className":2919},[],[2921],{"type":47,"value":1320},{"type":47,"value":2902},{"type":41,"tag":87,"props":2924,"children":2926},{"className":2925},[],[2927],{"type":47,"value":1180},{"type":47,"value":2595},{"type":41,"tag":76,"props":2930,"children":2931},{},[2932,2936,2937,2942,2944],{"type":41,"tag":66,"props":2933,"children":2934},{},[2935],{"type":47,"value":1472},{"type":47,"value":2895},{"type":41,"tag":87,"props":2938,"children":2940},{"className":2939},[],[2941],{"type":47,"value":1486},{"type":47,"value":2943}," for subdirectories containing ",{"type":41,"tag":87,"props":2945,"children":2947},{"className":2946},[],[2948],{"type":47,"value":1500},{"type":41,"tag":76,"props":2950,"children":2951},{},[2952,2956,2958,2963],{"type":41,"tag":66,"props":2953,"children":2954},{},[2955],{"type":47,"value":1649},{"type":47,"value":2957},": Loads configuration from ",{"type":41,"tag":87,"props":2959,"children":2961},{"className":2960},[],[2962],{"type":47,"value":1663},{"type":47,"value":2964}," or manifest",{"type":41,"tag":76,"props":2966,"children":2967},{},[2968,2973,2974,2979],{"type":41,"tag":66,"props":2969,"children":2970},{},[2971],{"type":47,"value":2972},"MCP servers",{"type":47,"value":2957},{"type":41,"tag":87,"props":2975,"children":2977},{"className":2976},[],[2978],{"type":47,"value":1969},{"type":47,"value":2964},{"type":41,"tag":57,"props":2981,"children":2982},{},[2983,2988],{"type":41,"tag":66,"props":2984,"children":2985},{},[2986],{"type":47,"value":2987},"Discovery timing",{"type":47,"value":227},{"type":41,"tag":72,"props":2990,"children":2991},{},[2992,2997,3002],{"type":41,"tag":76,"props":2993,"children":2994},{},[2995],{"type":47,"value":2996},"Plugin installation: Components register with Claude Code",{"type":41,"tag":76,"props":2998,"children":2999},{},[3000],{"type":47,"value":3001},"Plugin enable: Components become available for use",{"type":41,"tag":76,"props":3003,"children":3004},{},[3005],{"type":47,"value":3006},"No restart required: Changes take effect on next Claude Code session",{"type":41,"tag":57,"props":3008,"children":3009},{},[3010,3015,3017,3022],{"type":41,"tag":66,"props":3011,"children":3012},{},[3013],{"type":47,"value":3014},"Override behavior",{"type":47,"value":3016},": Custom paths in ",{"type":41,"tag":87,"props":3018,"children":3020},{"className":3019},[],[3021],{"type":47,"value":164},{"type":47,"value":3023}," supplement (not replace) default directories",{"type":41,"tag":50,"props":3025,"children":3027},{"id":3026},"best-practices",[3028],{"type":47,"value":3029},"Best Practices",{"type":41,"tag":229,"props":3031,"children":3033},{"id":3032},"organization",[3034],{"type":47,"value":3035},"Organization",{"type":41,"tag":146,"props":3037,"children":3038},{},[3039,3070,3105],{"type":41,"tag":76,"props":3040,"children":3041},{},[3042,3047,3049],{"type":41,"tag":66,"props":3043,"children":3044},{},[3045],{"type":47,"value":3046},"Logical grouping",{"type":47,"value":3048},": Group related components together",{"type":41,"tag":72,"props":3050,"children":3051},{},[3052,3057],{"type":41,"tag":76,"props":3053,"children":3054},{},[3055],{"type":47,"value":3056},"Put test-related commands, agents, and skills together",{"type":41,"tag":76,"props":3058,"children":3059},{},[3060,3062,3068],{"type":47,"value":3061},"Create subdirectories in ",{"type":41,"tag":87,"props":3063,"children":3065},{"className":3064},[],[3066],{"type":47,"value":3067},"scripts\u002F",{"type":47,"value":3069}," for different purposes",{"type":41,"tag":76,"props":3071,"children":3072},{},[3073,3078,3080,3085,3087],{"type":41,"tag":66,"props":3074,"children":3075},{},[3076],{"type":47,"value":3077},"Minimal manifest",{"type":47,"value":3079},": Keep ",{"type":41,"tag":87,"props":3081,"children":3083},{"className":3082},[],[3084],{"type":47,"value":164},{"type":47,"value":3086}," lean",{"type":41,"tag":72,"props":3088,"children":3089},{},[3090,3095,3100],{"type":41,"tag":76,"props":3091,"children":3092},{},[3093],{"type":47,"value":3094},"Only specify custom paths when necessary",{"type":41,"tag":76,"props":3096,"children":3097},{},[3098],{"type":47,"value":3099},"Rely on auto-discovery for standard layouts",{"type":41,"tag":76,"props":3101,"children":3102},{},[3103],{"type":47,"value":3104},"Use inline configuration only for simple cases",{"type":41,"tag":76,"props":3106,"children":3107},{},[3108,3112,3114],{"type":41,"tag":66,"props":3109,"children":3110},{},[3111],{"type":47,"value":2785},{"type":47,"value":3113},": Include README files",{"type":41,"tag":72,"props":3115,"children":3116},{},[3117,3122,3127],{"type":41,"tag":76,"props":3118,"children":3119},{},[3120],{"type":47,"value":3121},"Plugin root: Overall purpose and usage",{"type":41,"tag":76,"props":3123,"children":3124},{},[3125],{"type":47,"value":3126},"Component directories: Specific guidance",{"type":41,"tag":76,"props":3128,"children":3129},{},[3130],{"type":47,"value":3131},"Script directories: Usage and requirements",{"type":41,"tag":229,"props":3133,"children":3135},{"id":3134},"naming",[3136],{"type":47,"value":3137},"Naming",{"type":41,"tag":146,"props":3139,"children":3140},{},[3141,3177,3233],{"type":41,"tag":76,"props":3142,"children":3143},{},[3144,3149,3151],{"type":41,"tag":66,"props":3145,"children":3146},{},[3147],{"type":47,"value":3148},"Consistency",{"type":47,"value":3150},": Use consistent naming across components",{"type":41,"tag":72,"props":3152,"children":3153},{},[3154,3172],{"type":41,"tag":76,"props":3155,"children":3156},{},[3157,3159,3164,3166],{"type":47,"value":3158},"If command is ",{"type":41,"tag":87,"props":3160,"children":3162},{"className":3161},[],[3163],{"type":47,"value":349},{"type":47,"value":3165},", name related agent ",{"type":41,"tag":87,"props":3167,"children":3169},{"className":3168},[],[3170],{"type":47,"value":3171},"test-runner-agent",{"type":41,"tag":76,"props":3173,"children":3174},{},[3175],{"type":47,"value":3176},"Match skill directory names to their purpose",{"type":41,"tag":76,"props":3178,"children":3179},{},[3180,3185,3187],{"type":41,"tag":66,"props":3181,"children":3182},{},[3183],{"type":47,"value":3184},"Clarity",{"type":47,"value":3186},": Use descriptive names that indicate purpose",{"type":41,"tag":72,"props":3188,"children":3189},{},[3190,3208],{"type":41,"tag":76,"props":3191,"children":3192},{},[3193,3195,3201,3202],{"type":47,"value":3194},"Good: ",{"type":41,"tag":87,"props":3196,"children":3198},{"className":3197},[],[3199],{"type":47,"value":3200},"api-integration-testing\u002F",{"type":47,"value":343},{"type":41,"tag":87,"props":3203,"children":3205},{"className":3204},[],[3206],{"type":47,"value":3207},"code-quality-checker.md",{"type":41,"tag":76,"props":3209,"children":3210},{},[3211,3213,3219,3220,3226,3227],{"type":47,"value":3212},"Avoid: ",{"type":41,"tag":87,"props":3214,"children":3216},{"className":3215},[],[3217],{"type":47,"value":3218},"utils\u002F",{"type":47,"value":343},{"type":41,"tag":87,"props":3221,"children":3223},{"className":3222},[],[3224],{"type":47,"value":3225},"misc.md",{"type":47,"value":343},{"type":41,"tag":87,"props":3228,"children":3230},{"className":3229},[],[3231],{"type":47,"value":3232},"temp.sh",{"type":41,"tag":76,"props":3234,"children":3235},{},[3236,3241,3243],{"type":41,"tag":66,"props":3237,"children":3238},{},[3239],{"type":47,"value":3240},"Length",{"type":47,"value":3242},": Balance brevity with clarity",{"type":41,"tag":72,"props":3244,"children":3245},{},[3246,3265,3284],{"type":41,"tag":76,"props":3247,"children":3248},{},[3249,3251,3257,3258,3264],{"type":47,"value":3250},"Commands: 2-3 words (",{"type":41,"tag":87,"props":3252,"children":3254},{"className":3253},[],[3255],{"type":47,"value":3256},"review-pr",{"type":47,"value":343},{"type":41,"tag":87,"props":3259,"children":3261},{"className":3260},[],[3262],{"type":47,"value":3263},"run-ci",{"type":47,"value":2395},{"type":41,"tag":76,"props":3266,"children":3267},{},[3268,3270,3276,3277,3283],{"type":47,"value":3269},"Agents: Describe role clearly (",{"type":41,"tag":87,"props":3271,"children":3273},{"className":3272},[],[3274],{"type":47,"value":3275},"code-reviewer",{"type":47,"value":343},{"type":41,"tag":87,"props":3278,"children":3280},{"className":3279},[],[3281],{"type":47,"value":3282},"test-generator",{"type":47,"value":2395},{"type":41,"tag":76,"props":3285,"children":3286},{},[3287,3289,3295,3296,3302],{"type":47,"value":3288},"Skills: Topic-focused (",{"type":41,"tag":87,"props":3290,"children":3292},{"className":3291},[],[3293],{"type":47,"value":3294},"error-handling",{"type":47,"value":343},{"type":41,"tag":87,"props":3297,"children":3299},{"className":3298},[],[3300],{"type":47,"value":3301},"api-design",{"type":47,"value":2395},{"type":41,"tag":229,"props":3304,"children":3306},{"id":3305},"portability",[3307],{"type":47,"value":3308},"Portability",{"type":41,"tag":146,"props":3310,"children":3311},{},[3312,3322,3332,3342],{"type":41,"tag":76,"props":3313,"children":3314},{},[3315,3320],{"type":41,"tag":66,"props":3316,"children":3317},{},[3318],{"type":47,"value":3319},"Always use ${CLAUDE_PLUGIN_ROOT}",{"type":47,"value":3321},": Never hardcode paths",{"type":41,"tag":76,"props":3323,"children":3324},{},[3325,3330],{"type":41,"tag":66,"props":3326,"children":3327},{},[3328],{"type":47,"value":3329},"Test on multiple systems",{"type":47,"value":3331},": Verify on macOS, Linux, Windows",{"type":41,"tag":76,"props":3333,"children":3334},{},[3335,3340],{"type":41,"tag":66,"props":3336,"children":3337},{},[3338],{"type":47,"value":3339},"Document dependencies",{"type":47,"value":3341},": List required tools and versions",{"type":41,"tag":76,"props":3343,"children":3344},{},[3345,3350],{"type":41,"tag":66,"props":3346,"children":3347},{},[3348],{"type":47,"value":3349},"Avoid system-specific features",{"type":47,"value":3351},": Use portable bash\u002FPython constructs",{"type":41,"tag":229,"props":3353,"children":3355},{"id":3354},"maintenance",[3356],{"type":47,"value":3357},"Maintenance",{"type":41,"tag":146,"props":3359,"children":3360},{},[3361,3371,3381,3391],{"type":41,"tag":76,"props":3362,"children":3363},{},[3364,3369],{"type":41,"tag":66,"props":3365,"children":3366},{},[3367],{"type":47,"value":3368},"Version consistently",{"type":47,"value":3370},": Update version in plugin.json for releases",{"type":41,"tag":76,"props":3372,"children":3373},{},[3374,3379],{"type":41,"tag":66,"props":3375,"children":3376},{},[3377],{"type":47,"value":3378},"Deprecate gracefully",{"type":47,"value":3380},": Mark old components clearly before removal",{"type":41,"tag":76,"props":3382,"children":3383},{},[3384,3389],{"type":41,"tag":66,"props":3385,"children":3386},{},[3387],{"type":47,"value":3388},"Document breaking changes",{"type":47,"value":3390},": Note changes affecting existing users",{"type":41,"tag":76,"props":3392,"children":3393},{},[3394,3399],{"type":41,"tag":66,"props":3395,"children":3396},{},[3397],{"type":47,"value":3398},"Test thoroughly",{"type":47,"value":3400},": Verify all components work after changes",{"type":41,"tag":50,"props":3402,"children":3404},{"id":3403},"common-patterns",[3405],{"type":47,"value":3406},"Common Patterns",{"type":41,"tag":229,"props":3408,"children":3410},{"id":3409},"minimal-plugin",[3411],{"type":47,"value":3412},"Minimal Plugin",{"type":41,"tag":57,"props":3414,"children":3415},{},[3416],{"type":47,"value":3417},"Single command with no dependencies:",{"type":41,"tag":126,"props":3419,"children":3422},{"className":3420,"code":3421,"language":47},[129],"my-plugin\u002F\n├── .claude-plugin\u002F\n│   └── plugin.json    # Just name field\n└── commands\u002F\n    └── hello.md       # Single command\n",[3423],{"type":41,"tag":87,"props":3424,"children":3425},{"__ignoreMap":134},[3426],{"type":47,"value":3421},{"type":41,"tag":229,"props":3428,"children":3430},{"id":3429},"full-featured-plugin",[3431],{"type":47,"value":3432},"Full-Featured Plugin",{"type":41,"tag":57,"props":3434,"children":3435},{},[3436],{"type":47,"value":3437},"Complete plugin with all component types:",{"type":41,"tag":126,"props":3439,"children":3442},{"className":3440,"code":3441,"language":47},[129],"my-plugin\u002F\n├── .claude-plugin\u002F\n│   └── plugin.json\n├── commands\u002F          # User-facing commands\n├── agents\u002F            # Specialized subagents\n├── skills\u002F            # Auto-activating skills\n├── hooks\u002F             # Event handlers\n│   ├── hooks.json\n│   └── scripts\u002F\n├── .mcp.json          # External integrations\n└── scripts\u002F           # Shared utilities\n",[3443],{"type":41,"tag":87,"props":3444,"children":3445},{"__ignoreMap":134},[3446],{"type":47,"value":3441},{"type":41,"tag":229,"props":3448,"children":3450},{"id":3449},"skill-focused-plugin",[3451],{"type":47,"value":3452},"Skill-Focused Plugin",{"type":41,"tag":57,"props":3454,"children":3455},{},[3456],{"type":47,"value":3457},"Plugin providing only skills:",{"type":41,"tag":126,"props":3459,"children":3462},{"className":3460,"code":3461,"language":47},[129],"my-plugin\u002F\n├── .claude-plugin\u002F\n│   └── plugin.json\n└── skills\u002F\n    ├── skill-one\u002F\n    │   └── SKILL.md\n    └── skill-two\u002F\n        └── SKILL.md\n",[3463],{"type":41,"tag":87,"props":3464,"children":3465},{"__ignoreMap":134},[3466],{"type":47,"value":3461},{"type":41,"tag":50,"props":3468,"children":3470},{"id":3469},"troubleshooting",[3471],{"type":47,"value":3472},"Troubleshooting",{"type":41,"tag":57,"props":3474,"children":3475},{},[3476,3481],{"type":41,"tag":66,"props":3477,"children":3478},{},[3479],{"type":47,"value":3480},"Component not loading",{"type":47,"value":227},{"type":41,"tag":72,"props":3483,"children":3484},{},[3485,3490,3495,3515],{"type":41,"tag":76,"props":3486,"children":3487},{},[3488],{"type":47,"value":3489},"Verify file is in correct directory with correct extension",{"type":41,"tag":76,"props":3491,"children":3492},{},[3493],{"type":47,"value":3494},"Check YAML frontmatter syntax (commands, agents, skills)",{"type":41,"tag":76,"props":3496,"children":3497},{},[3498,3500,3505,3507,3513],{"type":47,"value":3499},"Ensure skill has ",{"type":41,"tag":87,"props":3501,"children":3503},{"className":3502},[],[3504],{"type":47,"value":1500},{"type":47,"value":3506}," (not ",{"type":41,"tag":87,"props":3508,"children":3510},{"className":3509},[],[3511],{"type":47,"value":3512},"README.md",{"type":47,"value":3514}," or other name)",{"type":41,"tag":76,"props":3516,"children":3517},{},[3518],{"type":47,"value":3519},"Confirm plugin is enabled in Claude Code settings",{"type":41,"tag":57,"props":3521,"children":3522},{},[3523,3528],{"type":41,"tag":66,"props":3524,"children":3525},{},[3526],{"type":47,"value":3527},"Path resolution errors",{"type":47,"value":227},{"type":41,"tag":72,"props":3530,"children":3531},{},[3532,3542,3554,3559],{"type":41,"tag":76,"props":3533,"children":3534},{},[3535,3537],{"type":47,"value":3536},"Replace all hardcoded paths with ",{"type":41,"tag":87,"props":3538,"children":3540},{"className":3539},[],[3541],{"type":47,"value":108},{"type":41,"tag":76,"props":3543,"children":3544},{},[3545,3547,3552],{"type":47,"value":3546},"Verify paths are relative and start with ",{"type":41,"tag":87,"props":3548,"children":3550},{"className":3549},[],[3551],{"type":47,"value":1121},{"type":47,"value":3553}," in manifest",{"type":41,"tag":76,"props":3555,"children":3556},{},[3557],{"type":47,"value":3558},"Check that referenced files exist at specified paths",{"type":41,"tag":76,"props":3560,"children":3561},{},[3562,3564,3570],{"type":47,"value":3563},"Test with ",{"type":41,"tag":87,"props":3565,"children":3567},{"className":3566},[],[3568],{"type":47,"value":3569},"echo $CLAUDE_PLUGIN_ROOT",{"type":47,"value":3571}," in hook scripts",{"type":41,"tag":57,"props":3573,"children":3574},{},[3575,3580],{"type":41,"tag":66,"props":3576,"children":3577},{},[3578],{"type":47,"value":3579},"Auto-discovery not working",{"type":47,"value":227},{"type":41,"tag":72,"props":3582,"children":3583},{},[3584,3595,3600,3605],{"type":41,"tag":76,"props":3585,"children":3586},{},[3587,3589,3594],{"type":47,"value":3588},"Confirm directories are at plugin root (not in ",{"type":41,"tag":87,"props":3590,"children":3592},{"className":3591},[],[3593],{"type":47,"value":172},{"type":47,"value":2395},{"type":41,"tag":76,"props":3596,"children":3597},{},[3598],{"type":47,"value":3599},"Check file naming follows conventions (kebab-case, correct extensions)",{"type":41,"tag":76,"props":3601,"children":3602},{},[3603],{"type":47,"value":3604},"Verify custom paths in manifest are correct",{"type":41,"tag":76,"props":3606,"children":3607},{},[3608],{"type":47,"value":3609},"Restart Claude Code to reload plugin configuration",{"type":41,"tag":57,"props":3611,"children":3612},{},[3613,3618],{"type":41,"tag":66,"props":3614,"children":3615},{},[3616],{"type":47,"value":3617},"Conflicts between plugins",{"type":47,"value":227},{"type":41,"tag":72,"props":3620,"children":3621},{},[3622,3627,3632,3637],{"type":41,"tag":76,"props":3623,"children":3624},{},[3625],{"type":47,"value":3626},"Use unique, descriptive component names",{"type":41,"tag":76,"props":3628,"children":3629},{},[3630],{"type":47,"value":3631},"Namespace commands with plugin name if needed",{"type":41,"tag":76,"props":3633,"children":3634},{},[3635],{"type":47,"value":3636},"Document potential conflicts in plugin README",{"type":41,"tag":76,"props":3638,"children":3639},{},[3640],{"type":47,"value":3641},"Consider command prefixes for related functionality",{"type":41,"tag":3643,"props":3644,"children":3645},"hr",{},[],{"type":41,"tag":57,"props":3647,"children":3648},{},[3649,3651,3657,3659,3665],{"type":47,"value":3650},"For detailed examples and advanced patterns, see files in ",{"type":41,"tag":87,"props":3652,"children":3654},{"className":3653},[],[3655],{"type":47,"value":3656},"references\u002F",{"type":47,"value":3658}," and ",{"type":41,"tag":87,"props":3660,"children":3662},{"className":3661},[],[3663],{"type":47,"value":3664},"examples\u002F",{"type":47,"value":3666}," directories.",{"type":41,"tag":3668,"props":3669,"children":3670},"style",{},[3671],{"type":47,"value":3672},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":3674,"total":3775},[3675,3691,3703,3718,3731,3744,3763],{"slug":3676,"name":3676,"fn":3677,"description":3678,"org":3679,"tags":3680,"stars":20,"repoUrl":21,"updatedAt":3690},"access","manage iMessage channel access and permissions","Manage iMessage channel access — approve pairings, edit allowlists, set DM\u002Fgroup policy. Use when the user asks to pair, approve someone, check who's allowed, or change policy for the iMessage channel.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3681,3684,3687],{"name":3682,"slug":3683,"type":16},"Access Control","access-control",{"name":3685,"slug":3686,"type":16},"iMessage","imessage",{"name":3688,"slug":3689,"type":16},"Messaging","messaging","2026-04-12T04:54:55.917969",{"slug":3692,"name":3692,"fn":3693,"description":3694,"org":3695,"tags":3696,"stars":20,"repoUrl":21,"updatedAt":3702},"agent-development","develop and configure AI agents","This skill should be used when the user asks to \"create an agent\", \"add an agent\", \"write a subagent\", \"agent frontmatter\", \"when to use description\", \"agent examples\", \"agent tools\", \"agent colors\", \"autonomous agent\", or needs guidance on agent structure, system prompts, triggering conditions, or agent development best practices for Claude Code plugins.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3697,3698,3699,3701],{"name":1306,"slug":960,"type":16},{"name":9,"slug":8,"type":16},{"name":2785,"slug":3700,"type":16},"documentation",{"name":18,"slug":19,"type":16},"2026-04-10T04:55:41.251084",{"slug":3704,"name":3704,"fn":3705,"description":3706,"org":3707,"tags":3708,"stars":20,"repoUrl":21,"updatedAt":3717},"build-mcp-app","build MCP apps with interactive UI","This skill should be used when the user wants to build an \"MCP app\", add \"interactive UI\" or \"widgets\" to an MCP server, \"render components in chat\", build \"MCP UI resources\", make a tool that shows a \"form\", \"picker\", \"dashboard\" or \"confirmation dialog\" inline in the conversation, or mentions \"apps SDK\" in the context of MCP. Use AFTER the build-mcp-server skill has settled the deployment model, or when the user already knows they want UI widgets.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3709,3710,3712,3714],{"name":1306,"slug":960,"type":16},{"name":3711,"slug":26,"type":16},"Claude Code",{"name":3713,"slug":27,"type":16},"MCP",{"name":3715,"slug":3716,"type":16},"UI Components","ui-components","2026-04-06T17:59:32.421865",{"slug":3719,"name":3719,"fn":3720,"description":3721,"org":3722,"tags":3723,"stars":20,"repoUrl":21,"updatedAt":3730},"build-mcp-server","build MCP servers","This skill should be used when the user asks to \"build an MCP server\", \"create an MCP\", \"make an MCP integration\", \"wrap an API for Claude\", \"expose tools to Claude\", \"make an MCP app\", or discusses building something with the Model Context Protocol. It is the entry point for MCP server development — it interrogates the user about their use case, determines the right deployment model (remote HTTP, MCPB, local stdio), picks a tool-design pattern, and hands off to specialized skills.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3724,3725,3728,3729],{"name":1306,"slug":960,"type":16},{"name":3726,"slug":3727,"type":16},"API Development","api-development",{"name":3711,"slug":26,"type":16},{"name":3713,"slug":27,"type":16},"2026-04-06T17:59:33.744601",{"slug":3732,"name":3732,"fn":3733,"description":3734,"org":3735,"tags":3736,"stars":20,"repoUrl":21,"updatedAt":3743},"build-mcpb","package and distribute MCP servers","This skill should be used when the user wants to \"package an MCP server\", \"bundle an MCP\", \"make an MCPB\", \"ship a local MCP server\", \"distribute a local MCP\", discusses \".mcpb files\", mentions bundling a Node or Python runtime with their MCP server, or needs an MCP server that interacts with the local filesystem, desktop apps, or OS and must be installable without the user having Node\u002FPython set up.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3737,3738,3739,3740],{"name":1306,"slug":960,"type":16},{"name":3711,"slug":26,"type":16},{"name":3713,"slug":27,"type":16},{"name":3741,"slug":3742,"type":16},"Packaging","packaging","2026-04-06T17:59:31.159961",{"slug":3745,"name":3745,"fn":3746,"description":3747,"org":3748,"tags":3749,"stars":20,"repoUrl":21,"updatedAt":3762},"cardputer-buddy","develop MicroPython apps for Cardputer","Iterate on the Cardputer-Adv MicroPython app bundle (Claude Buddy, Snake, Hello) after the device is already provisioned via m5-onboard. Use when the user wants to add a new app, push a single changed .py without re-flashing, watch device serial logs, or run a one-shot REPL command. Trigger on \"add an app\", \"push to the cardputer\", \"tail the device\", \"run on the device\", or follow-up work after \u002Fmaker-setup.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3750,3753,3756,3759],{"name":3751,"slug":3752,"type":16},"Hardware","hardware",{"name":3754,"slug":3755,"type":16},"M5Stack","m5stack",{"name":3757,"slug":3758,"type":16},"MicroPython","micropython",{"name":3760,"slug":3761,"type":16},"Python","python","2026-05-06T05:39:00.134385",{"slug":3764,"name":3764,"fn":3765,"description":3766,"org":3767,"tags":3768,"stars":20,"repoUrl":21,"updatedAt":3774},"claude-automation-recommender","recommend Claude Code automations","Analyze a codebase and recommend Claude Code automations (hooks, subagents, skills, plugins, MCP servers). Use when user asks for automation recommendations, wants to optimize their Claude Code setup, mentions improving Claude Code workflows, asks how to first set up Claude Code for a project, or wants to know what Claude Code features they should use.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3769,3772,3773],{"name":3770,"slug":3771,"type":16},"Agent Context","agent-context",{"name":3711,"slug":26,"type":16},{"name":3713,"slug":27,"type":16},"2026-04-06T18:00:34.049624",25,{"items":3777,"total":3953},[3778,3799,3813,3825,3842,3853,3874,3892,3906,3916,3924,3937],{"slug":3779,"name":3779,"fn":3780,"description":3781,"org":3782,"tags":3783,"stars":3796,"repoUrl":3797,"updatedAt":3798},"algorithmic-art","create algorithmic art with p5.js","Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3784,3787,3790,3793],{"name":3785,"slug":3786,"type":16},"Creative","creative",{"name":3788,"slug":3789,"type":16},"Design","design",{"name":3791,"slug":3792,"type":16},"Generative Art","generative-art",{"name":3794,"slug":3795,"type":16},"JavaScript","javascript",161831,"https:\u002F\u002Fgithub.com\u002Fanthropics\u002Fskills","2026-04-06T17:56:15.455818",{"slug":3800,"name":3800,"fn":3801,"description":3802,"org":3803,"tags":3804,"stars":3796,"repoUrl":3797,"updatedAt":3812},"brand-guidelines","apply Anthropic brand colors and typography","Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3805,3808,3809],{"name":3806,"slug":3807,"type":16},"Branding","branding",{"name":3788,"slug":3789,"type":16},{"name":3810,"slug":3811,"type":16},"Typography","typography","2026-04-06T17:56:05.042852",{"slug":3814,"name":3814,"fn":3815,"description":3816,"org":3817,"tags":3818,"stars":3796,"repoUrl":3797,"updatedAt":3824},"canvas-design","create posters and visual art as PNG or PDF","Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3819,3820,3821],{"name":3785,"slug":3786,"type":16},{"name":3788,"slug":3789,"type":16},{"name":3822,"slug":3823,"type":16},"PDF","pdf","2026-04-06T17:56:03.794732",{"slug":3826,"name":3826,"fn":3827,"description":3828,"org":3829,"tags":3830,"stars":3796,"repoUrl":3797,"updatedAt":3841},"claude-api","build apps with the Claude API","Reference for the Claude API \u002F Anthropic SDK — model ids, pricing, params, streaming, tool use, MCP, agents, caching, token counting, model migration.\nTRIGGER — read BEFORE opening the target file; don't skip because it \"looks like a one-liner\" — whenever: the prompt names Claude\u002FAnthropic in any form (Claude, Anthropic, Fable, Opus, Sonnet, Haiku, `anthropic`, `@anthropic-ai`, `claude-*`, `us.anthropic.*`, `[1m]`); the user asks about an LLM (pricing\u002Fmodel choice\u002Flimits\u002Fcaching) — never answer from memory; OR the task is LLM-shaped with provider unstated (agent\u002FMCP\u002Ftool-definition\u002Fmulti-agent\u002FRAG\u002FLLM-judge\u002Fcomputer-use; generate\u002Fsummarize\u002Fextract\u002Fclassify\u002Frewrite\u002Fconverse over NL; debugging refusals\u002Fcutoffs\u002Fstreaming\u002Ftool-calls\u002Ftokens).\nSKIP only when another provider is being worked on (overrides all triggers): OpenAI\u002FGPT\u002FGemini\u002FLlama\u002FMistral\u002FCohere\u002FOllama named in the query; OR `grep -rE 'openai|langchain_openai|google.generativeai|genai|mistralai|cohere|ollama'` over the project hits (run this grep FIRST if no provider named — don't Read the file).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3831,3832,3833,3836,3838],{"name":1306,"slug":960,"type":16},{"name":9,"slug":8,"type":16},{"name":3834,"slug":3835,"type":16},"Anthropic SDK","anthropic-sdk",{"name":3837,"slug":3826,"type":16},"Claude API",{"name":3839,"slug":3840,"type":16},"LLM","llm","2026-07-28T05:36:08.213335",{"slug":3843,"name":3843,"fn":3844,"description":3845,"org":3846,"tags":3847,"stars":3796,"repoUrl":3797,"updatedAt":3852},"doc-coauthoring","co-author documentation and technical specs","Guide users through a structured workflow for co-authoring documentation. Use when user wants to write documentation, proposals, technical specs, decision docs, or similar structured content. This workflow helps users efficiently transfer context, refine content through iteration, and verify the doc works for readers. Trigger when user mentions writing docs, creating proposals, drafting specs, or similar documentation tasks.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3848,3849],{"name":2785,"slug":3700,"type":16},{"name":3850,"slug":3851,"type":16},"Technical Writing","technical-writing","2026-04-06T17:56:14.18897",{"slug":3854,"name":3854,"fn":3855,"description":3856,"org":3857,"tags":3858,"stars":3796,"repoUrl":3797,"updatedAt":3873},"docx","create and edit Word documents","Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3859,3862,3864,3867,3870],{"name":3860,"slug":3861,"type":16},"Documents","documents",{"name":3863,"slug":3854,"type":16},"DOCX",{"name":3865,"slug":3866,"type":16},"Office","office",{"name":3868,"slug":3869,"type":16},"Templates","templates",{"name":3871,"slug":3872,"type":16},"Word","word","2026-07-18T05:16:23.136271",{"slug":3875,"name":3875,"fn":3876,"description":3877,"org":3878,"tags":3879,"stars":3796,"repoUrl":3797,"updatedAt":3891},"frontend-design","design production-grade frontend interfaces","Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3880,3881,3884,3887,3890],{"name":3788,"slug":3789,"type":16},{"name":3882,"slug":3883,"type":16},"Frontend","frontend",{"name":3885,"slug":3886,"type":16},"React","react",{"name":3888,"slug":3889,"type":16},"Tailwind CSS","tailwind-css",{"name":3715,"slug":3716,"type":16},"2026-04-06T17:56:16.723469",{"slug":3893,"name":3893,"fn":3894,"description":3895,"org":3896,"tags":3897,"stars":3796,"repoUrl":3797,"updatedAt":3905},"internal-comms","write internal company communications","A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates, etc.).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3898,3901,3902],{"name":3899,"slug":3900,"type":16},"Communications","communications",{"name":3868,"slug":3869,"type":16},{"name":3903,"slug":3904,"type":16},"Writing","writing","2026-04-06T17:56:20.695522",{"slug":3907,"name":3907,"fn":3720,"description":3908,"org":3909,"tags":3910,"stars":3796,"repoUrl":3797,"updatedAt":3915},"mcp-builder","Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node\u002FTypeScript (MCP SDK).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3911,3912,3913,3914],{"name":1306,"slug":960,"type":16},{"name":3726,"slug":3727,"type":16},{"name":3839,"slug":3840,"type":16},{"name":3713,"slug":27,"type":16},"2026-04-06T17:56:10.357665",{"slug":3823,"name":3823,"fn":3917,"description":3918,"org":3919,"tags":3920,"stars":3796,"repoUrl":3797,"updatedAt":3923},"read edit and manipulate PDF files","Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text\u002Ftables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting\u002Fdecrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3921,3922],{"name":3860,"slug":3861,"type":16},{"name":3822,"slug":3823,"type":16},"2026-04-06T17:56:02.483316",{"slug":3925,"name":3925,"fn":3926,"description":3927,"org":3928,"tags":3929,"stars":3796,"repoUrl":3797,"updatedAt":3936},"pptx","create and edit PowerPoint presentations","Use this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions \"deck,\" \"slides,\" \"presentation,\" or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3930,3933],{"name":3931,"slug":3932,"type":16},"PowerPoint","powerpoint",{"name":3934,"slug":3935,"type":16},"Presentations","presentations","2026-07-18T05:16:24.1471",{"slug":3938,"name":3938,"fn":3939,"description":3940,"org":3941,"tags":3942,"stars":3796,"repoUrl":3797,"updatedAt":3952},"skill-creator","create and optimize agent skills","Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":11},[3943,3944,3945,3948,3951],{"name":1306,"slug":960,"type":16},{"name":2785,"slug":3700,"type":16},{"name":3946,"slug":3947,"type":16},"Evals","evals",{"name":3949,"slug":3950,"type":16},"Performance","performance",{"name":3850,"slug":3851,"type":16},"2026-04-19T06:45:40.804",490]