lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

skill intermedio claude-codejevtypesafeskillsapi

TypeSafe: integra decisiones tipadas en tu aplicación con Jev

Clasifica solicitudes o elige entre candidatos con ayuda de Jev, manteniendo las reglas de negocio en tu código. La skill guía a tu agente al diseñar preguntas y tratar respuestas ambiguas.

✓ verificado el 26 oct 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en ClaudeChatGPT

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.

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 indica:

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

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

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

ver en .md ¿Prefieres el recurso entero?

Qué es

TypeSafe Agent Skills contiene instrucciones para que un agente de programación construya integraciones con System One. Su skill typesafe-ai enseña a formular juicios sobre los datos que envías a Jev y a convertir las respuestas en comportamiento de aplicación.

Para qué te sirve

  • Clasificar solicitudes de soporte y derivar los casos inciertos.
  • Elegir entre candidatos ya obtenidos por tu aplicación.
  • Revisar preguntas, opciones y reglas cuando una integración produce resultados erróneos.

Cómo funciona

El código prepara el estado y plantea preguntas tipadas: Choice elige una opción; Noul estima si una afirmación es cierta; Score valora niveles descritos; Box localiza un elemento en una imagen. La skill orienta al agente sobre qué preguntar y remite a la documentación vigente para los esquemas exactos.

El principio central es mantener la lógica de negocio en código. Por ejemplo, el modelo puede juzgar si un mensaje expresa frustración; tu aplicación decide si eso exige una revisión humana. Varias preguntas que comparten estado pueden agruparse, pero cada una se responde sin ver las respuestas de las demás.

Antes de empezar

Para leer e instalar la skill necesitas un arnés compatible. El README ofrece un plugin de Claude Code y una instalación mediante skills.sh para otros agentes. Para ejecutar la integración necesitas acceso a la API de TypeSafe y una clave de servidor; instalar las instrucciones no concede acceso al servicio ni incluye su consumo.

GitHub registra licencia MIT, repositorio no archivado y último commit del 23 oct 2026. Los requisitos del SDK dependen del lenguaje que elijas y deben comprobarse en su documentación.

Límites y alternativas

Las probabilidades no garantizan aciertos. La skill advierte que la concentración de una distribución, llamada confidence (concentración de probabilidades), no equivale a la probabilidad de acertar. Diseña una salida para estados ambiguos, errores de API y casos en los que ninguna opción encaje.

La propia guía recomienda resolver con código los cálculos, fechas, búsquedas exactas y políticas que ya puedan expresarse de forma fiable. Conserva un modelo generativo cuando el trabajo requiera producir contenido libre. Evalúa cualquier sustitución con ejemplos representativos y casos que no hayas usado al ajustar las preguntas.

Recursos