Configurar agentes de programación con SKILL.md

npx skills add phaseoteam/skills --agent codex --skill '*'

• mantén la configuración del SDK dentro del repositorio
• añade un archivo SKILL.md que explique al agente cómo espera el proyecto que se envíen las solicitudes
• durante la configuración, indica al agente que consulte ese archivo para mantener coherentes los patrones de solicitud

​

1. Instala el SDK

npm install @phaseo/sdk

pnpm add @phaseo/sdk

yarn add @phaseo/sdk

bun add @phaseo/sdk

pip install phaseo

​

2. Añade un archivo de habilidades local al proyecto

# Phaseo Gateway

- Use `https://api.phaseo.app/v1` as the gateway base URL.
- Read the API key from `PHASEO_API_KEY`.
- Prefer the Responses API for new text integrations.
- Use preset slugs when the repository defines shared request defaults.
- Log request ids and model ids for debugging.
- For async video jobs, store the returned id and poll status until terminal.

​

3. Mantén pequeña la primera integración

import Phaseo from "@phaseo/sdk";

export const gateway = new Phaseo({
  apiKey: process.env.PHASEO_API_KEY!,
});

• generación de texto
• vídeo asíncrono
• embeddings
• generación de imágenes

​

4. Qué debe incluir la habilidad

• qué familia de endpoints deben preferir
• qué variable de entorno contiene las credenciales
• qué IDs de modelo o nombres de preajustes están aprobados
• cómo registrar los IDs de solicitud
• cómo hacer seguimiento de los trabajos asíncronos

​

5. Patrón recomendado para el repositorio

• un módulo compartido con las funciones auxiliares del SDK
• SKILL.md junto al código de integración o en la raíz del repositorio
• un ejemplo breve para cada endpoint principal
• una nota sobre el registro de solicitudes y la gestión de errores

​

Guías relacionadas

• Codex
• Integración con AI SDK
• Ejemplos