Habilidad de agente

Habilidad lista para usar en Claude Code, Codex y otros entornos de agentes.

La habilidad de agente de TypeSafe le da a tu agente de programación con IA el contexto completo sobre la API de TypeSafe: los tres tipos de pregunta, los patrones arquitectónicos y las buenas prácticas para estructurar evaluaciones.

Instalación

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

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

Install the TypeSafe skill. If you're in Claude Code, run `claude plugin marketplace add typesafe-ai/skills`, then `claude plugin install typesafe@typesafe-ai`. If you're in another agent, run `npx skills add typesafe-ai/skills --skill typesafe-ai` and select your agent. Use one installation method. You can read the skill directly at https://github.com/typesafe-ai/skills/blob/main/skills/typesafe-ai/SKILL.md (raw: https://raw.githubusercontent.com/typesafe-ai/skills/main/skills/typesafe-ai/SKILL.md). Then use the TypeSafe skill when working on this project.

Lee SKILL.md en GitHub u obtén directamente el Markdown sin procesar. Para la instalación manual, copia todo el directorio skills/typesafe-ai, incluidos sus archivos de referencia, en el directorio de habilidades de tu agente.

Elige un solo método de instalación para evitar copias duplicadas.

Actualizaciones

Para el plugin de Claude Code, ejecuta:

claude plugin marketplace update typesafe-ai
claude plugin update typesafe@typesafe-ai

Reinicia Claude Code o ejecuta /reload-plugins para cargar la actualización. Para habilitar las actualizaciones automáticas, abre /plugin y selecciona Marketplaces → typesafe-ai → Enable auto-update.

Para instalaciones con skills.sh, ejecuta npx skills update. Para copias manuales, reemplaza todo el directorio de la habilidad con la última versión de GitHub.

Prompts de ejemplo

Nombrar la habilidad en tu prompt —«use the TypeSafe skill»— funciona en cualquier agente, así que cada uno de los prompts de abajo lo hace. Con el plugin de Claude Code, también puedes invocar /typesafe:typesafe-ai directamente.

• Un buen prompt para empezar es uno de lluvia de ideas que te ayude a encontrar dónde puede aprovecharse mejor TypeSafe en un proyecto.

  Using the TypeSafe skill, explore the project and find opportunities for using
  intelligent judgement to stand in for complex parsing or other fragile code.

• También puedes crear una clave de API y darle permiso a tu agente para que averigüe la mejor forma de usar TypeSafe ejecutando consultas de prueba baratas.

  Using the TypeSafe skill, run some experiments using the TypeSafe API key that I've
  exported to `TYPESAFE_API_KEY`. Propose changes based on the most promising results.

• Dirige tu agente a un cookbook concreto que resuelva un problema que tengas en tu base de código, o apúntalo al índice de cookbooks y pregúntale si hay algún patrón parecido a los de tu proyecto.

  Using the TypeSafe skill, analyze my code and see if there are any applicable
  cookbooks (https://console.typesafe.ai/docs/cookbooks) that show how I could
  refactor my code to be less fragile or complex.

Principios de un buen vibe coding

1. Habla con tu agente, usando los prompts de ejemplo de arriba como punto de partida.
2. Revisa el plan y asegúrate de que tenga sentido antes de implementarlo.
3. Coloca las constantes (preguntas y umbrales) en un solo sitio para que sean fáciles de revisar. Los agentes no son buenos escribiendo preguntas, así que cuenta con editarlas en colaboración con ellos.
4. No des por buenas las afirmaciones sin más; anima al agente a validar sus suposiciones.

Problemas frecuentes

El agente no usa la habilidad

Con el plugin de Claude Code, invoca /typesafe:typesafe-ai. En otros agentes, pide que «use the TypeSafe skill». Si aun así no se carga, confirma que el instalador apuntó al agente que estás usando y reinícialo.

El enrutamiento no funciona como esperas

Revisa las preguntas y los umbrales. Es posible que tus umbrales estén demasiado altos (lo que provoca falsos negativos) o demasiado bajos (lo que provoca falsos positivos). También puede que necesites ajustar tus preguntas para que sean más específicas.

Usas umbrales de confianza en todas partes

Si lo único que te importa es elegir la mejor opción, basta con que elijas la opción con mayor confianza (en lugar de fijar un umbral de confianza). Si tienes en mente un algoritmo estadístico concreto, probablemente deberías usar probabilidades en lugar de confianza.

Es difícil revisar el código de TypeSafe

Lo más importante que deben revisar las personas son las preguntas y las constantes de umbral que se usen en tu código de TypeSafe. Deberían definirse en un único archivo de código para que sea fácil encontrarlas sin demasiada exploración.

El agente inventa campos de la solicitud o la respuesta

Una habilidad desactualizada puede causarlo. Actualízala con el método de instalación de arriba y vuelve a intentarlo.