Communitygithub.com

YepAPI/skills

Padrões de API GPT, chamada de funções, saídas estruturadas com Zod, streaming e gerenciamento de tokens.

O que é skills?

Esta skill fornece diretrizes e padrões abrangentes para integração com a API da OpenAI, focando em chamada de funções, saídas estruturadas, streaming e gerenciamento eficiente de tokens. Ela é útil para desenvolvedores que desejam construir aplicações robustas com modelos GPT, garantindo boas práticas como uso de streaming para respostas em tempo real, definição de funções com JSON Schema e seleção inteligente de modelos (gpt-4o para tarefas complexas, gpt-4o-mini para tarefas simples). A skill também aborda gerenciamento de tokens, limitação de taxa e tratamento de erros, com exemplos práticos em TypeScript. Ela suporta qualquer plataforma que utilize a API OpenAI diretamente, como aplicações Node.js, e incentiva o uso de variáveis de ambiente para chaves de API e configuração de temperatura para controle de criatividade.

Funciona com~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/YepAPI/skills/tree/HEAD/skills/openai-integration

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Integração com OpenAI

Regras

  • Use o pacote oficial openai — new OpenAI({ apiKey: process.env.OPENAI_API_KEY })
  • Streaming para chat: stream: true com iterador assíncrono — nunca bloqueie até a conclusão completa para respostas voltadas ao usuário
  • Chamada de funções: defina funções com JSON Schema, lide com tool_calls na resposta e retorne resultados como mensagens de ferramenta
  • Saídas estruturadas: use response_format: { type: "json_schema", json_schema: {...} } ou Zod com AI SDK
  • Gerenciamento de tokens: estime tokens antes de enviar (aproximadamente 4 caracteres por token), corte o contexto para permanecer dentro dos limites
  • Seleção de modelo: gpt-4o para raciocínio complexo, gpt-4o-mini para tarefas simples — torne-o configurável
  • Prompt do sistema como primeira mensagem — defina tom, restrições e formato de saída
  • Temperatura: 0 para saídas determinísticas (extração de dados), 0,7-1,0 para tarefas criativas
  • Limitação de taxa: respeite os cabeçalhos x-ratelimit-*, implemente backoff exponencial em erros 429

Padrões

// Streaming de conclusão
const stream = await openai.chat.completions.create({
  model: "gpt-4o",
  messages,
  stream: true,
});

for await (const chunk of stream) {
  const content = chunk.choices[0]?.delta?.content || "";
  process.stdout.write(content);
}
// Chamada de funções
const response = await openai.chat.completions.create({
  model: "gpt-4o",
  messages,
  tools: [{ type: "function", function: { name: "get_weather", parameters: schema } }],
});

Evite

  • Codificar chaves de API — sempre use variáveis de ambiente
  • Ignorar limites de tokens — conte tokens e corte mensagens proativamente
  • Usar gpt-4o para tarefas triviais — use gpt-4o-mini para economizar custos
  • Faltar com tratamento de erros nas chamadas de API — lide com erros 429, 500 e timeout de forma elegante

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

YepAPI/skills

WCAG 2.1 AA — semantic HTML, keyboard navigation, screen readers.

YepAPI/skills

Experiment setup, variant splitting, statistical significance, and feature flag integration.

YepAPI/skills

CRUD generators, data tables, user management, role-based access, and bulk operations.

YepAPI/skills

Monitor what ChatGPT and Gemini say about your brand using YepAPI.

YepAPI/skills

Queue workers with BullMQ/Inngest/Trigger.dev, job retries, dead letter queues, concurrency.

YepAPI/skills

Commander.js, interactive prompts with Clack, spinners, colors, config files, exit codes, and npm publishing.

YepAPI/skills

cmdk integration, Cmd+K trigger, fuzzy search, grouped actions, keyboard navigation, and dynamic action registration.

YepAPI/skills

Content planning with trend and sentiment data from YepAPI.

YepAPI/skills

Content calendar, keyword-driven planning, and content briefs.

YepAPI/skills

Theme switching with CSS variables, system preference detection, next-themes, and persistence.

YepAPI/skills

Threaded comments, @mentions, reactions, moderation queue, optimistic UI, and cursor pagination.

YepAPI/skills

Competitive analysis between domains using YepAPI.

YepAPI/skills

Layout grids, KPI cards, data tables with sorting/filtering, sidebar navigation, and responsive breakpoints.

YepAPI/skills

Data encryption — TLS everywhere, AES-256-GCM for PII, bcrypt passwords, encrypted backups.

YepAPI/skills

Chart patterns with Recharts/Nivo/D3, responsive containers, color scales, and accessibility.

YepAPI/skills

Drizzle schema definition, push vs migrate, type-safe queries, relations, transactions, and prepared statements.

YepAPI/skills

Upload handling, resize/compress, CDN delivery, blur placeholders, and next/image patterns.

YepAPI/skills

Local business and Google Maps research using YepAPI.

YepAPI/skills

Cursor-based pagination, IntersectionObserver, virtualized lists with @tanstack/react-virtual, and scroll position restoration.

YepAPI/skills

Chat UI components, streaming responses with AI SDK, context window management, and RAG patterns.

Habilidades Relacionadas