SKILL.md a tu repositorio para que los agentes de programación llamen a Phaseo como espera tu proyecto: la misma URL base, la misma variable de la clave, el mismo endpoint, los modelos aprobados y el mismo registro. Al terminar tendrás instaladas las skills públicas de Phaseo, una skill del proyecto encima de ellas y un módulo de cliente compartido al que apunta la skill.
La skill y el módulo de abajo están listos para producción en cuanto sustituyas los IDs de modelo y los nombres de preajuste por los tuyos.
1
Instala las skills públicas de Phaseo
Las skills públicas cubren el Gateway, los SDKs, los preajustes, el enrutamiento y las migraciones. Instálalas desde Cambia
phaseo.app/docs:--agent por el agente que usa tu equipo. Deja en tu propio SKILL.md solo las reglas específicas del proyecto.2
Instala el SDK
3
Añade un cliente compartido
Los agentes reutilizan un helper pequeño y evidente con más fiabilidad que un wrapper grande. Pon el cliente en un módulo e impórtalo en todas partes:Mantén una sola ruta de llamada por cada superficie que uses, como generación de texto, embeddings, generación de imágenes o vídeo asíncrono.
src/lib/phaseo.ts
4
Escribe la skill del proyecto
Crea
SKILL.md en la raíz del repositorio o en la carpeta de skills que lee tu agente (por ejemplo, .agents/skills/phaseo-project/SKILL.md). El agente lee el name y la description del frontmatter para decidir cuándo cargar la skill:SKILL.md
Comprueba que ha funcionado
Pide a tu agente que añada una pequeña función de Phaseo, como “resume un ticket con Phaseo”. El cambio debería importarsrc/lib/phaseo.ts, leer PHASEO_API_KEY, usar un modelo o preajuste aprobado y registrar el ID de la respuesta. Si no lo hace, lo más probable es que la description de la skill no coincida con la petición: nombra las palabras que usa tu equipo para esa tarea.
Qué poner en la skill
Responde a las preguntas que más tiempo le cuestan a un agente, y a nada más:
Codex, el Vercel AI SDK y Ejemplos muestran las mismas convenciones en cada herramienta.