# Hook Development > Guía completa para crear e implementar hooks de plugins de Claude Code, con énfasis en la API avanzada de hooks basados en prompt. Fuente: https://skillsagentes.com/skills/anthropics/claude-code/hook-development Markdown: https://skillsagentes.com/skills/anthropics/claude-code/hook-development.md Repositorio: https://github.com/anthropics/claude-code Autor: anthropics Licencia: no declarada Actualizado: hace 10 meses Coste de contexto: 131 tok instalada, 4.1k tok al activarse, 16.1k tok con todos los archivos del bundle Bundle: 11 archivos, 63 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 hook-development --agent claude-code # Cursor npx -y skills add anthropics/claude-code --skill hook-development --agent cursor # Codex npx -y skills add anthropics/claude-code --skill hook-development --agent codex # Gemini CLI npx -y skills add anthropics/claude-code --skill hook-development --agent gemini # Windsurf npx -y skills add anthropics/claude-code --skill hook-development --agent windsurf # Cline npx -y skills add anthropics/claude-code --skill hook-development --agent cline ``` ## Qué hace - Configura hooks de eventos en `hooks/hooks.json` para validar, modificar o reaccionar a acciones de Claude Code - Implementa hooks basados en prompt (LLM) o en comandos bash para eventos como PreToolUse, Stop, SessionStart - Define matchers, formatos de salida JSON, códigos de salida y variables de entorno como `${CLAUDE_PLUGIN_ROOT}` - Aplica buenas prácticas de seguridad: validación de entradas, prevención de path traversal, comillas en variables bash ## Cuándo usarla - El usuario pide crear un hook o añadir un hook PreToolUse/PostToolUse/Stop - Se necesita validar el uso de herramientas o bloquear comandos peligrosos - Se quiere usar `${CLAUDE_PLUGIN_ROOT}` o configurar automatización basada en eventos - Se menciona algún evento de hook (SessionStart, UserPromptSubmit, PreCompact, Notification, etc.) ## Qué la activa - "Crea un hook PreToolUse que valide escrituras de archivos" - "Añade un hook Stop que verifique que las pruebas pasaron antes de terminar" - "Configura un hook SessionStart que cargue contexto del proyecto" - "Necesito bloquear comandos bash peligrosos con un hook" ## Antes de instalar - Requiere `jq` para procesar JSON en hooks de comando y familiaridad con `hooks/hooks.json` del plugin. - Necesita en el PATH: jq - Variables de entorno: CLAUDE_ENV_FILE, CLAUDE_PLUGIN_ROOT, CLAUDE_PROJECT_DIR, CONFIG_FILE, FLAG_FILE, HOOKS_FILE, HOOK_SCRIPT, TEST_INPUT, TIMEOUT, TOOL_INPUT, VALID_EVENTS, VERBOSE - reads environment config ## Archivos - SKILL.md — 16 KB - examples/load-context.sh — 2 KB - examples/validate-bash.sh — 1 KB - examples/validate-write.sh — 1 KB - references/advanced.md — 10 KB - references/migration.md — 8 KB - references/patterns.md — 7 KB - scripts/README.md — 4 KB - scripts/hook-linter.sh — 4 KB - scripts/test-hook.sh — 5 KB - scripts/validate-hook-schema.sh — 5 KB ## SKILL.md No se reproduce aquí. Léelo en https://github.com/anthropics/claude-code/blob/main/plugins/plugin-dev/skills/hook-development/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. - [MCP Integration](https://skillsagentes.com/skills/anthropics/claude-code/mcp-integration.md): Guía completa para integrar servidores Model Context Protocol en plugins de Claude Code, para conectar herramientas y servicios externos. ## 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)