openai-responses-api

What problem does it solve?

This Skill ensures that the OpenAI Responses API is used correctly, preventing the accidental use of the deprecated Chat Completions API and enforcing proper request structures and parameters.

Core Features & Use Cases

• Enforces Responses API: Guarantees that client.responses.create is used instead of client.chat.completions.create.
• Correct Request Shapes: Mandates the use of input= and other Responses API specific parameters.
• Model Management: Promotes using environment variables for model selection with safe defaults and handles NotFoundError.
• Structured Output & Tool Calling: Guides on using text={"format": ...} for structured data and the Responses API's tool-calling mechanism.
• Use Case: When integrating with OpenAI, this Skill acts as a guardrail to ensure developers adhere to the latest API standards, improving compatibility and leveraging new features like structured output and efficient multi-turn conversations.

Quick Start

Use the openai-responses-api skill to make a call to the OpenAI Responses API using the provided Python template.