# Plugin Structure

> Úsalo para crear plugins, definir su estructura, configurar plugin.json, usar ${CLAUDE_PLUGIN_ROOT}, añadir commands/agents/skills/hooks o entender el auto-discovery.

Fuente: https://skillsagentes.com/skills/anthropics/claude-code/plugin-structure
Markdown: https://skillsagentes.com/skills/anthropics/claude-code/plugin-structure.md

Repositorio: https://github.com/anthropics/claude-code
Autor: anthropics
Licencia: no declarada
Actualizado: hace 10 meses
Coste de contexto: 108 tok instalada, 3.4k tok al activarse, 18.7k tok con todos los archivos del bundle
Bundle: 7 archivos, 73 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add anthropics/claude-code --skill plugin-structure --agent claude-code
# Cursor
npx -y skills add anthropics/claude-code --skill plugin-structure --agent cursor
# Codex
npx -y skills add anthropics/claude-code --skill plugin-structure --agent codex
# Gemini CLI
npx -y skills add anthropics/claude-code --skill plugin-structure --agent gemini
# Windsurf
npx -y skills add anthropics/claude-code --skill plugin-structure --agent windsurf
# Cline
npx -y skills add anthropics/claude-code --skill plugin-structure --agent cline
```

## Qué hace

- 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

## Cuándo usarla

- 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

## Qué la activa

- "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?"

## Antes de instalar

- Variables de entorno: API_KEY, CLAUDE_PLUGIN_ROOT
- makes network requests
- needs API credentials

## Archivos

- 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

No se reproduce aquí. Léelo en https://github.com/anthropics/claude-code/blob/main/plugins/plugin-dev/skills/plugin-structure/SKILL.md

## Dónde encaja

- Categoría: [Herramientas para desarrolladores](https://skillsagentes.com/categorias/herramientas-desarrollo.md) — Skills que cambian cómo tu agente escribe, revisa y despliega código.
- Creador: [anthropics](https://skillsagentes.com/creators/anthropics.md) — 30 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Frontend Design](https://skillsagentes.com/skills/anthropics/claude-code/frontend-design.md): Guía para un diseño visual distintivo e intencional al crear o rediseñar una UI: dirección estética, tipografía y decisiones que no parezcan defaults templados.
- [Claude Opus 4 5 Migration](https://skillsagentes.com/skills/anthropics/claude-code/claude-opus-4-5-migration.md): Migra prompts y código desde Claude Sonnet 4.0, Sonnet 4.5 u Opus 4.1 hacia Opus 4.5, actualizando strings de modelo y ajustando prompts según diferencias de comportamiento conocidas. No migra Haiku 4.5.
- [Agent Development](https://skillsagentes.com/skills/anthropics/claude-code/agent-development.md): Úsala cuando el usuario pida "crear un agente", "añadir un agente", "escribir un subagente" o necesite guía sobre estructura, frontmatter, ejemplos, tools o colores de agentes en plugins de Claude Code.
- [Command Development](https://skillsagentes.com/skills/anthropics/claude-code/command-development.md): Guía para crear slash commands en Claude Code: estructura de archivos, frontmatter YAML, argumentos dinámicos, referencias a archivos y buenas prácticas.
- [Hook Development](https://skillsagentes.com/skills/anthropics/claude-code/hook-development.md): Guía completa para crear e implementar hooks de plugins de Claude Code, con énfasis en la API avanzada de hooks basados en prompt.

## Skills relacionadas

- [Finishing A Development Branch](https://skillsagentes.com/skills/obra/superpowers/finishing-a-development-branch.md): Úsalo cuando la implementación esté completa, todos los tests pasen, y necesites decidir cómo integrar el trabajo.
- [Using Git Worktrees](https://skillsagentes.com/skills/obra/superpowers/using-git-worktrees.md): Úsalo al empezar trabajo de feature que necesita aislamiento del workspace actual, o antes de ejecutar planes de implementación: asegura un workspace aislado vía herramientas nativas o fallback a git worktree.
- [Writing Skills](https://skillsagentes.com/skills/obra/superpowers/writing-skills.md): Úsala al crear nuevas skills, editar skills existentes o verificar que funcionan antes de desplegarlas.
- [Code Review](https://skillsagentes.com/skills/mattpocock/skills/code-review.md): Revisa los cambios desde un punto fijo por dos ejes — Standards (¿sigue los estándares del repo?) y Spec (¿hace lo que pedía el issue?) — en sub-agentes paralelos, y los reporta lado a lado.
- [Codebase Design](https://skillsagentes.com/skills/mattpocock/skills/codebase-design.md): Vocabulario compartido para diseñar módulos profundos. Úsalo para diseñar o mejorar la interfaz de un módulo, decidir dónde va un seam, o hacer el código más testeable y navegable para una IA.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)