Claude Code Cookbook

April 14, 2026 · View on GitHub

Una colección de configuraciones para hacer que Claude Code sea más fácil de usar.

Al evitar confirmaciones detalladas y proceder automáticamente con las tareas, puedes concentrarte en lo que realmente quieres hacer. Claude Code juzga y ejecuta tareas comunes como corrección de código, ejecución de pruebas y actualización de documentación.

Características Principales

Puedes personalizar el comportamiento de Claude Code con tres funciones:

Commands: Comandos personalizados que comienzan con /
Roles: Configuraciones de roles para responder desde perspectivas de expertos
Hooks: Ejecución automática de scripts en momentos específicos

Lista de Funciones

Commands (Comandos Personalizados)

Guardados como archivos Markdown en el directorio /commands. Se ejecutan escribiendo / seguido del nombre del archivo.

Comando	Descripción
`/analyze-dependencies`	Analiza las dependencias del proyecto y visualiza dependencias circulares y problemas estructurales.
`/analyze-performance`	Analiza problemas de rendimiento de la aplicación y propone mejoras desde la perspectiva de deuda técnica.
`/check-fact`	Verifica la veracidad de la información proporcionada consultando el código y documentación del proyecto.
`/pr-checks`	Monitoriza el estado de CI de GitHub Actions y rastrea hasta completarse.
`/check-prompt`	Revisa el contenido del prompt actual y presenta sugerencias de mejora.
`/commit-message`	Genera solo el mensaje de commit basado en los cambios.
`/context7`	Gestiona el contexto usando Context7 MCP.
`/design-patterns`	Propone y revisa implementaciones basadas en patrones de diseño.
`/explain-code`	Explica claramente la funcionalidad y lógica del código seleccionado.
`/fix-error`	Propone soluciones de código basadas en mensajes de error.
`/multi-role`	Combina múltiples roles para análisis paralelo del mismo objetivo y genera un informe integrado.
`/plan`	Activa el modo de planificación previa a la implementación y formula estrategias detalladas.
`/pr-auto-update`	Actualiza automáticamente el contenido del Pull Request (descripción, etiquetas).
`/pr-create`	Crea PRs automáticamente basándose en análisis de cambios Git para un flujo de trabajo eficiente.
`/pr-fix`	Responde eficientemente a comentarios de revisión de PR con enfoque de tres etapas para solución fundamental.
`/pr-issue`	Muestra lista de Issues abiertas del repositorio actual con priorización.
`/pr-list`	Muestra lista de PRs abiertos del repositorio actual con priorización.
`/pr-review`	Asegura calidad del código y salud arquitectónica con revisión sistemática de PR.
`/refactor`	Ejecuta refactorización segura y gradual evaluando cumplimiento de principios SOLID.
`/role-debate`	Hace que múltiples roles debatan sobre un tema específico.
`/role-help`	Muestra lista y descripción de Roles disponibles.
`/role`	Actúa como el rol especificado.
`/screenshot`	Captura y analiza capturas de pantalla.
`/search-gemini`	Realiza búsquedas web usando Gemini.
`/semantic-commit`	Divide cambios grandes en unidades mínimas significativas con mensajes de commit semánticos.
`/sequential-thinking`	Usa Sequential Thinking MCP para pensar problemas complejos paso a paso y llegar a conclusiones.
`/show-plan`	Muestra el plan de ejecución actual.
`/smart-review`	Realiza revisiones avanzadas para mejorar la calidad del código.
`/spec`	Crea especificaciones detalladas paso a paso siguiendo el desarrollo dirigido por especificaciones de Kiro.
`/style-ai-writing`	Detecta y corrige texto antinatural generado por IA.
`/task`	Lanza agentes dedicados para ejecutar tareas complejas de búsqueda, investigación y análisis de forma autónoma.
`/tech-debt`	Analiza la deuda técnica del proyecto y crea un plan de mejora priorizado.
`/ultrathink`	Ejecuta un proceso de pensamiento estructurado y gradual para problemas complejos o decisiones importantes.
`/update-dart-doc`	Gestiona sistemáticamente comentarios DartDoc en archivos Dart y mantiene documentación de alta calidad.
`/update-doc-string`	Gestiona y actualiza cadenas de documentación de forma unificada para múltiples idiomas.
`/update-flutter-deps`	Actualiza de forma segura las dependencias del proyecto Flutter.
`/update-node-deps`	Actualiza de forma segura las dependencias del proyecto Node.js.
`/update-rust-deps`	Actualiza de forma segura las dependencias del proyecto Rust.

Roles (Configuración de Roles)

Definidos en archivos Markdown dentro del directorio agents/roles/. Permite que Claude tenga perspectivas de expertos para respuestas más precisas.

Cada rol también puede ejecutarse independientemente como subagente. Usando la opción --agent, puedes ejecutar análisis a gran escala o procesamiento especializado en paralelo sin interferir con el contexto de conversación principal.

Rol	Descripción
`/role analyzer`	Como experto en análisis de sistemas, analiza código y arquitectura.
`/role architect`	Como arquitecto de software, revisa y propone sobre diseño.
`/role backend`	Como experto en desarrollo backend, asesora sobre diseño de API, microservicios, cloud-native y arquitectura serverless.
`/role frontend`	Como experto en frontend, asesora sobre UI/UX y rendimiento.
`/role mobile`	Como experto en desarrollo móvil, responde basándose en mejores prácticas de iOS/Android.
`/role performance`	Como experto en optimización de rendimiento, propone mejoras de velocidad y uso de memoria.
`/role qa`	Como ingeniero QA, revisa desde la perspectiva de planes de prueba y aseguramiento de calidad.
`/role reviewer`	Como revisor de código, evalúa código desde perspectivas de legibilidad y mantenibilidad.
`/role security`	Como experto en seguridad, señala vulnerabilidades y riesgos de seguridad.

Ejemplos de Ejecución de Subagentes

# Modo normal (ejecuta en contexto principal)
/cook-es:role security
"Verificación de seguridad de este proyecto"

# Modo subagente (ejecuta en contexto independiente)
/cook-es:role security --agent
"Ejecutar auditoría de seguridad completa del proyecto"

# Análisis paralelo de múltiples roles
/cook-es:multi-role security,performance --agent
"Análisis integral de seguridad y rendimiento del sistema completo"

Hooks (Scripts de Automatización)

Configure en settings.json para automatizar tareas de desarrollo.

Script de Ejecución	Evento	Descripción
`preserve-file-permissions.sh`	`PreToolUse` / `PostToolUse`	Guarda permisos originales antes de editar archivo y restaura después de edición. Previene que Claude Code cambie permisos.

Flujo de Desarrollo y Guía de Uso de Comandos

Ejemplos de Uso de Comandos en Flujo de Desarrollo Típico

flowchart TB
    Start([Verificar Tarea]) --> PRList["/cook-es:pr-list<br/>Lista PRs Abiertos"]
    Start --> PRIssue["/cook-es:pr-issue<br/>Lista Issues Abiertas"]

    PRList --> TaskType{¿Tipo?}
    PRIssue --> TaskType

    TaskType -->|Nueva Funcionalidad| Plan["/cook-es:spec<br/>Definición de Requisitos ・Diseño"]
    TaskType -->|Corrección de Bug| Fix["/cook-es:fix-error<br/>Análisis de Error"]
    TaskType -->|Refactorización| Refactor["/cook-es:refactor<br/>Mejora"]
    TaskType -->|Revisión| Review["/cook-es:pr-review<br/>Revisión"]

    Plan --> Design["/cook-es:role architect<br/>/cook-es:role-debate<br/>Consulta de Diseño"]
    Design --> Implementation[Implementación ・Prueba]
    Fix --> Implementation
    Refactor --> Implementation
    Review --> Implementation

    Implementation --> Check["/cook-es:smart-review<br/>Verificación de Calidad"]
    Check --> Commit["/cook-es:semantic-commit<br/>Commit por Unidad de Objetivo"]
    Commit --> PR["/cook-es:pr-create<br/>Creación Automática de PR"]
    PR --> CI["/cook-es:pr-checks<br/>Verificación de Estado CI"]

    CI --> Status{¿Hay Problema?}
    Status -->|Sí| Feedback["Responder Corrección<br/>/cook-es:pr-fix<br/>/cook-es:fix-error"]
    Status -->|No| End([Concluido])

    Feedback --> Implementation

    classDef commandBox fill:#e0f2fe,stroke:#0369a1,stroke-width:2px,rx:5,ry:5,color:#0c4a6e
    classDef processBox fill:#f0f9ff,stroke:#0ea5e9,stroke-width:1px,rx:5,ry:5,color:#075985
    classDef decisionBox fill:#fef3c7,stroke:#f59e0b,stroke-width:2px,rx:5,ry:5,color:#78350f
    classDef startEnd fill:#86efac,stroke:#22c55e,stroke-width:2px,rx:20,ry:20,color:#14532d

    class PRList,PRIssue,Plan,Fix,Refactor,Review,Design,Check,CI,Commit,PR,Feedback commandBox
    class Implementation processBox
    class TaskType,Status decisionBox
    class Start,End startEnd

    %%{init: {'theme':'base', 'themeVariables': { 'primaryColor':'#e0f2fe', 'primaryTextColor':'#0c4a6e', 'primaryBorderColor':'#0369a1', 'lineColor':'#64748b', 'secondaryColor':'#f0f9ff', 'background':'#ffffff', 'mainBkg':'#ffffff', 'fontSize': '14px'}}}%%

Instalación

Paso 1: Agregar el Marketplace

Primero, agrega este repositorio como un marketplace de plugins:

/plugin marketplace add wasabeef/claude-code-cookbook

Paso 2: Instalar el Plugin en Español

Luego, instala el plugin en versión española:

/plugin install cook-es@claude-code-cookbook

Este comando instala la versión en español de Commands y Roles.

Uso

Después de la instalación, los comandos y agentes se invocan con el prefijo cook-es::

Ejecutar Comandos

# Ejecutar con prefijo
/cook-es:check-fact

# Usar autocompletado
/cook-es:

Llamar Agentes

# Buscar agentes comenzando con @
@agent-cook-es:frontend

# También se puede usar mediante comando de rol
/cook-es:role frontend

Nota: El nombre del plugin se agrega automáticamente como prefijo. Esto evita conflictos de nombres cuando se instalan múltiples plugins de idioma simultáneamente.

Personalización

Agregar comandos: Solo agrega archivos .md en commands/
Agregar roles: Solo agrega archivos .md en agents/roles/
Editar Hooks: Edita settings.json para cambiar el procesamiento automático