# Plugin Structure

> 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/agents/skills/hooks", "configure auto-discovery", or needs guidance on plugin directory layout, manifest configuration, component organization, file naming conventions, or Claude Code plugin architecture best practices.

Source: https://skillsagentes.com/skills/anthropics/claude-code/plugin-structure
Repository: https://github.com/anthropics/claude-code
Author: anthropics
License: not specified
Updated: hace 9 meses
Context cost: 108 tok installed, 3.4k tok once triggered, 18.7k tok with every bundled file
Bundle: 7 files, 73 KB
Permissions requested: none declared

## Install

```bash
npx -y skills add anthropics/claude-code --skill plugin-structure --agent claude-code
```

## What it does

- Guía la creación de la estructura de directorios de un plugin de Claude Code con commands, agents, skills y hooks
- Explica el manifiesto .claude-plugin/plugin.json y sus campos requeridos y recomendados
- Documenta el uso de ${CLAUDE_PLUGIN_ROOT} para rutas portables
- Cubre convenciones de nombres kebab-case y el mecanismo de auto-discovery

## Use it when

- El usuario pide 'crear un plugin' o 'scaffold a plugin'
- Se necesita entender la estructura de directorios de un plugin
- Se configura plugin.json o se usa ${CLAUDE_PLUGIN_ROOT}
- Se añaden commands/agents/skills/hooks o se configura auto-discovery

## What triggers it

- "Ayúdame a crear un plugin para Claude Code"
- "¿Cómo organizo commands, agents y skills en mi plugin?"
- "Explícame cómo configurar plugin.json"
- "¿Cómo uso ${CLAUDE_PLUGIN_ROOT} en mis hooks?"

## Before you install

- Environment: API_KEY, CLAUDE_PLUGIN_ROOT

## Files

- README.md — 3 KB
- SKILL.md — 13 KB
- examples/advanced-plugin.md — 18 KB
- examples/minimal-plugin.md — 2 KB
- examples/standard-plugin.md — 13 KB
- references/component-patterns.md — 12 KB
- references/manifest-reference.md — 12 KB

## SKILL.md

Not reproduced here. Read it at https://github.com/anthropics/claude-code/blob/main/plugins/plugin-dev/skills/plugin-structure/SKILL.md

---

Skills Agentes — https://skillsagentes.com/skills/anthropics/claude-code/plugin-structure