# openai-api

> Builds or debugs OpenAI Chat Completions, Responses API, and OpenAI Agents SDK patterns, including function calling, structured output, streaming, and handoffs.

- Skill: `joshuashepherd/openai-api` (Agent Skill)
- Install (CLI): `npx skillmds add joshuashepherd/openai-api`
- Raw SKILL.md: https://api.skillmd.com/api/skills/joshuashepherd/openai-api/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs, REST & GraphQL APIs
- Tags: Agents Sdk, Chat Completions, Function Calling, Handoffs, Openai, Responses Api, Streaming, Structured Output
- Author: JoshuaShepherd (https://skillmd.com/u/joshuashepherd)
- Updated: 2026-08-22
- Page: https://skillmd.com/skills/joshuashepherd/openai-api

---


# OpenAI API (Cursor)

## Canonical source

**`.claude/skills/openai-api/SKILL.md`** lists **platform.openai.com** and **openai.github.io/openai-agents-python** references and implementation patterns.

## In Cursor

1. Read the canonical skill for the surface you need (`agents` vs `chat`).
2. Fetch current OpenAI docs (model list, API reference) before relying on model IDs or parameters.
3. OpenAI REST + Agents SDK entry: `src/lib/ai/clients/openai.ts` (`openaiClient`, `createAgent`, `createRunner`, re-exports `run`, `tool`, `fileSearchTool`).