openai · OpenAI Platform Docs
Advice On Prompting Reasoning models | OpenAI API
Provides specific prompting strategies and best practices for optimizing interactions with reasoning models, such as avoiding over-specification and managing complex instructions.
Derived skill
Files assembled from official documentation
Viewing SKILL.md
Advice On Prompting Reasoning models | OpenAI API
Provides specific prompting strategies and best practices for optimizing interactions with reasoning models, such as avoiding over-specification and managing complex instructions.
When To Use
Use when you need to optimize prompt structures to leverage the internal chain-of-thought capabilities of reasoning models without causing instruction conflicts.
Reference Files
| File | Contains | Use For |
|---|---|---|
SKILL.md | Entry point: scope, routing table, and workflow. | Start here. |
docs/reasoning-advice-on-prompting-models-openai-api-workflow-guide.md | A guide detailing best practices for prompting OpenAI reasoning models, including managing reasoning effort and context windows. | Questions about a guide detailing best practices for prompting OpenAI reasoning models, including managing reasoning effort and conte... |
examples/reasoning-advice-on-prompting-models-openai-api-openai-api-reasoning-mod.text | A Node.js code example demonstrating how to structure prompts and configure reasoning effort for OpenAI reasoning models. | Exact payloads, commands, or snippets shown in A Node.js code example demonstrating how to structure prompts and configure reasoning effort for OpenAI reasoning mod... |
examples/reasoning-advice-on-prompting-models-openai-api-openai-api-python-reason.text | A Python script demonstrating how to send a prompt to an OpenAI reasoning model using the OpenAI client library. | Exact payloads, commands, or snippets shown in A Python script demonstrating how to send a prompt to an OpenAI reasoning model using the OpenAI client library. |
examples/reasoning-advice-on-prompting-models-openai-api-openai-api-reasoning-mod-2.text | A curl command demonstrating how to send a request to the OpenAI API using a reasoning model with specified effort levels. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to send a request to the OpenAI API using a reasoning model with specified effort le... |
examples/reasoning-advice-on-prompting-models-openai-api-openai-reasoning-model-p.text | A text example demonstrating the usage object and reasoning token breakdown for an OpenAI reasoning model response. | Exact payloads, commands, or snippets shown in A text example demonstrating the usage object and reasoning token breakdown for an OpenAI reasoning model response. |
examples/reasoning-advice-on-prompting-models-openai-api-openai-reasoning-model-p-2.text | A JavaScript code snippet demonstrating how to structure a prompt for OpenAI reasoning models using the OpenAI SDK. | Exact payloads, commands, or snippets shown in A JavaScript code snippet demonstrating how to structure a prompt for OpenAI reasoning models using the OpenAI SDK. |
examples/reasoning-advice-on-prompting-models-openai-api-openai-api-python-reason-2.text | A Python script demonstrating how to use the OpenAI API to send a prompt to a reasoning model with specified reasoning effort. | Exact payloads, commands, or snippets shown in A Python script demonstrating how to use the OpenAI API to send a prompt to a reasoning model with specified reasonin... |
examples/reasoning-advice-on-prompting-models-openai-api-openai-api-reasoning-mod-3.text | A curl command demonstrating how to send a request to the OpenAI API using a reasoning model with specific effort and inclusion parameters. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to send a request to the OpenAI API using a reasoning model with specific effort and... |
examples/reasoning-advice-on-prompting-models-openai-api-openai-api-reasoning-mod-4.text | A Node.js code snippet demonstrating how to create a request using the OpenAI API with specific reasoning effort parameters. | Exact payloads, commands, or snippets shown in A Node.js code snippet demonstrating how to create a request using the OpenAI API with specific reasoning effort para... |
examples/reasoning-advice-on-prompting-models-openai-api-openai-api-reasoning-mod-5.text | A Python code snippet demonstrating how to call the OpenAI API with reasoning effort parameters using the OpenAI client. | Exact payloads, commands, or snippets shown in A Python code snippet demonstrating how to call the OpenAI API with reasoning effort parameters using the OpenAI client. |
examples/reasoning-advice-on-prompting-models-openai-api-openai-api-reasoning-mod-6.text | A curl command demonstrating how to send a request to the OpenAI API using a reasoning model with specific effort parameters. | Exact payloads, commands, or snippets shown in A curl command demonstrating how to send a request to the OpenAI API using a reasoning model with specific effort par... |
examples/reasoning-advice-on-prompting-models-openai-api-openai-reasoning-model-p-3.text | A text-based guide providing specific prompting strategies and best practices for interacting with OpenAI reasoning models. | Exact payloads, commands, or snippets shown in A text-based guide providing specific prompting strategies and best practices for interacting with OpenAI reasoning m... |
examples/reasoning-advice-on-prompting-models-openai-api-openai-reasoning-model-p-4.text | A text example demonstrating how to structure inputs and phases for prompting OpenAI reasoning models. | Exact payloads, commands, or snippets shown in A text example demonstrating how to structure inputs and phases for prompting OpenAI reasoning models. |
examples/reasoning-advice-on-prompting-models-openai-api-openai-reasoning-model-p-5.text | A Python code example demonstrating how to structure inputs for OpenAI reasoning models using specific assistant phases like commentary and finalanswer. | Exact payloads, commands, or snippets shown in A Python code example demonstrating how to structure inputs for OpenAI reasoning models using specific assistant phas... |
examples/reasoning-advice-on-prompting-models-openai-api-openai-reasoning-model-p-6.text | A text example demonstrating prompting techniques for OpenAI reasoning models using a React component instruction task. | Exact payloads, commands, or snippets shown in A text example demonstrating prompting techniques for OpenAI reasoning models using a React component instruction task. |
examples/reasoning-advice-on-prompting-models-openai-api-openai-reasoning-model-p-7.text | A Python code snippet demonstrating effective prompting techniques for OpenAI reasoning models using the OpenAI client. | Exact payloads, commands, or snippets shown in A Python code snippet demonstrating effective prompting techniques for OpenAI reasoning models using the OpenAI client. |
examples/reasoning-advice-on-prompting-models-openai-api-openai-reasoning-model-p-8.text | A Node.js code example demonstrating how to structure prompts for OpenAI reasoning models to follow specific formatting and instruction constraints. | Exact payloads, commands, or snippets shown in A Node.js code example demonstrating how to structure prompts for OpenAI reasoning models to follow specific formatti... |
examples/reasoning-advice-on-prompting-models-openai-api-openai-reasoning-model-p-9.text | A Python code example demonstrating how to structure instructions for OpenAI reasoning models to achieve specific formatting and constraint adherence. | Exact payloads, commands, or snippets shown in A Python code example demonstrating how to structure instructions for OpenAI reasoning models to achieve specific for... |
examples/reasoning-advice-on-prompting-models-openai-api-openai-reasoning-models-.text | A text-based example demonstrating prompting strategies for OpenAI reasoning models within a Python application context. | Exact payloads, commands, or snippets shown in A text-based example demonstrating prompting strategies for OpenAI reasoning models within a Python application context. |
examples/reasoning-advice-on-prompting-models-openai-api-openai-reasoning-models--2.text | A Python code example demonstrating how to implement prompting strategies for OpenAI reasoning models using the OpenAI client library. | Exact payloads, commands, or snippets shown in A Python code example demonstrating how to implement prompting strategies for OpenAI reasoning models using the OpenA... |
examples/reasoning-advice-on-prompting-models-openai-api-openai-reasoning-models--3.text | Textual examples demonstrating effective prompting strategies for OpenAI reasoning models. | Exact payloads, commands, or snippets shown in Textual examples demonstrating effective prompting strategies for OpenAI reasoning models. |
examples/reasoning-advice-on-prompting-models-openai-api-openai-reasoning-models--4.text | A Python code example demonstrating how to structure prompts for OpenAI reasoning models to improve task performance. | Exact payloads, commands, or snippets shown in A Python code example demonstrating how to structure prompts for OpenAI reasoning models to improve task performance. |
examples/reasoning-advice-on-prompting-models-openai-api-openai-reasoning-model-p-10.text | A Node.js code example demonstrating how to structure prompts for OpenAI reasoning models using the OpenAI SDK. | Exact payloads, commands, or snippets shown in A Node.js code example demonstrating how to structure prompts for OpenAI reasoning models using the OpenAI SDK. |
examples/reasoning-advice-on-prompting-models-openai-api-openai-api-python-reason-3.text | A Python script demonstrating how to structure a prompt for OpenAI reasoning models using the OpenAI client library. | Exact payloads, commands, or snippets shown in A Python script demonstrating how to structure a prompt for OpenAI reasoning models using the OpenAI client library. |
examples/reasoning-advice-on-prompting-models-openai-api-openai-api-reasoning-mod-7.text | A Node.js code example demonstrating how to structure prompts for OpenAI reasoning models using the OpenAI SDK. | Exact payloads, commands, or snippets shown in A Node.js code example demonstrating how to structure prompts for OpenAI reasoning models using the OpenAI SDK. |
examples/reasoning-advice-on-prompting-models-openai-api-openai-api-reasoning-mod-8.text | A Python code example demonstrating how to structure a prompt for OpenAI reasoning models using the OpenAI client. | Exact payloads, commands, or snippets shown in A Python code example demonstrating how to structure a prompt for OpenAI reasoning models using the OpenAI client. |
What This Skill Covers
- Reasoning models like GPT-5.5 use internal reasoning tokens before producing a response. This helps the model plan, use tools effectively, inspect alternativ...
- Main sections:
Get started with reasoning,Reasoning effort,How reasoning works,Managing the context window,Controlling costs.
Workflow
- Open the most relevant file under
docs/for the exact documented workflow and wording. - Open
schemas/files for exact structured contracts. - Open
examples/files for concrete requests, commands, snippets, and manifests. - Do not add behavior or configuration that is not present in the attached source files.
Canonical source: https://developers.openai.com/api/docs/guides/reasoning/advice-on-prompting