# Instrucciones para el agente: Claude Code Templates: instala agentes, comandos e integraciones

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/davila7/claude-code-templates (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/claude-code-templates

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Paso 1: revisa el componente

Comprueba que tienes Claude Code, Node.js ≥22 y npm/npx para la instalación actual sin versiones fijadas. El manifiesto de origen aún declara Node ≥14, pero `@clack/prompts` 1.5.1 exige ≥20.12 y la dependencia `@supabase/supabase-js` actual publicada en npm exige ≥22; se sigue el requisito más exigente de la cadena. Comprueba además npm/npx. En el repositorio donde vas a trabajar, comprueba los archivos de configuración existentes de Claude Code. Elige una sola pieza en el [catálogo](https://aitmpl.com) y lee su definición y licencia antes de instalarla.

### Paso 2: abre el instalador

El README documenta este modo interactivo:

```bash
npx claude-code-templates@latest
```

Selecciona el componente que necesitas. El mismo README da este ejemplo para un agente de revisión de código:

```bash
npx claude-code-templates@latest --agent development-tools/code-reviewer --yes
```

La segunda opción confirma sin interacción; úsala solo cuando ya hayas revisado el componente y su destino. No instales ambos ejemplos por defecto.

### Paso 3: revisa el resultado

Comprueba qué archivos añadió o modificó el instalador y adapta las instrucciones a las convenciones de tu proyecto. Si elegiste un MCP, sigue además la configuración oficial del servicio y concede solo el acceso necesario.

## Comprobación

El diagnóstico publicado por el proyecto se ejecuta así:

```bash
npx claude-code-templates@latest --health-check
```

Después prueba el agente o comando en una tarea pequeña del proyecto. Revisa su resultado: un diagnóstico correcto no demuestra que la plantilla resuelva tus tareas.

## Si algo falla

Comprueba el identificador del componente en el catálogo y los ejemplos actuales del [README](https://github.com/davila7/claude-code-templates/blob/HEAD/README.md). Revisa si ya existía una configuración incompatible. Si el MCP se instala pero no conecta, comprueba la configuración del servicio antes de repetir la instalación de toda la colección.
