Configure agentes de programação com SKILL.md

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

• mantenha a configuração do SDK dentro do repositório
• adicione um arquivo SKILL.md que ensine ao agente como o projeto espera que as solicitações sejam feitas
• durante a configuração, indique esse arquivo ao agente para manter os padrões de solicitação consistentes

​

1. Instale o SDK

npm install @phaseo/sdk

pnpm add @phaseo/sdk

yarn add @phaseo/sdk

bun add @phaseo/sdk

pip install phaseo

​

2. Adicione um arquivo de skill local do projeto

# 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. Mantenha a primeira integração pequena

import Phaseo from "@phaseo/sdk";

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

• geração de texto
• vídeo assíncrono
• embeddings
• geração de imagens

​

4. O que a skill deve registrar

• qual família de endpoints deve ser priorizada
• qual variável de ambiente contém as credenciais
• quais IDs de modelo ou slugs de predefinições são aprovados
• como registrar IDs de solicitação
• como acompanhar tarefas assíncronas

​

5. Padrão recomendado para o repositório

• um módulo compartilhado com funções auxiliares do SDK
• SKILL.md junto ao código de integração ou na raiz do repositório
• um exemplo curto para cada endpoint principal
• uma observação sobre logs de solicitações e tratamento de erros

​

Guias relacionados

• Codex
• Integração com AI SDK
• Exemplos