# Instrucciones para el agente: TypeSafe: integra decisiones tipadas en tu aplicación con Jev

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/typesafe-ai/skills (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/typesafe-system-one-skills

---

## 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

### Preparación

Comprueba Claude Code y su comando claude si eliges la ruta de plugin. Para la alternativa con skills.sh, comprueba Node.js ≥22.20.0 y npm/npx y abre la raíz del proyecto. Elige una sola vía.

### Paso 1: elige la instalación

En Claude Code, el [README oficial](https://github.com/typesafe-ai/skills/blob/302eea662c54bca6730873fe245bec1d69ebc23d/README.md) indica:

```bash
claude plugin marketplace add typesafe-ai/skills
claude plugin install typesafe@typesafe-ai
```

Para otros arneses compatibles, el mismo README ofrece esta alternativa:

```bash
npx skills add typesafe-ai/skills --skill typesafe-ai
```

Selecciona tu agente en el instalador. Por defecto se instala en el proyecto. Elige una de las rutas de instalación según tu arnés.

### Paso 2: delimita la primera integración

Pide al agente que use TypeSafe para clasificar solicitudes de soporte por departamento. Define las categorías y qué hacer cuando no haya información suficiente. En Claude Code puedes invocar la skill mediante `/typesafe:typesafe-ai`.

### Paso 3: diseña antes de llamar a la API

Haz que el agente lea la [skill](https://github.com/typesafe-ai/skills/blob/302eea662c54bca6730873fe245bec1d69ebc23d/skills/typesafe-ai/SKILL.md) y la documentación actual del SDK elegido desde https://docs.typesafe.ai/llms.txt. Prepara el estado, preguntas y reglas de actuación. No deduzcas el formato de una petición a partir de esta guía.

Para las pruebas en vivo, acuerda datos y presupuesto antes de ejecutarlas, como pide la skill. Guarda TYPESAFE_API_KEY solo en la configuración privada del servidor. No la envíes al navegador ni la pegues en el chat.

## Comprobación

Confirma que el arnés descubre la skill. Después evalúa la integración con ejemplos claros, ambiguos y negativos, incluidos casos nuevos. Comprueba que un fallo de red produce un error visible y que la aplicación tiene una acción definida para cada resultado.

## Si algo falla

Si el agente no encuentra la skill, revisa el ámbito y la ruta usados por el instalador. Si los juicios son erróneos, inspecciona primero la petición real, el estado y las opciones; después revisa las preguntas. Consulta las limitaciones del modelo en el índice oficial antes de añadir excepciones para cada ejemplo.