openai · OpenAI Platform Docs
Prompt guidance | OpenAI API
Teaches best practices for engineering effective prompts, including strategies for providing context, structuring instructions, using delimiters, and managing complex reasoning tasks.
Derived skill
Files assembled from official documentation
Viewing SKILL.md
Prompt guidance | OpenAI API
Teaches best practices for engineering effective prompts, including strategies for providing context, structuring instructions, using delimiters, and managing complex reasoning tasks.
When To Use
Use when you need to optimize model outputs through structured instruction design, context management, or specific prompting techniques like few-shot prompting or chain-of-thought reasoning.
Reference Files
| File | Contains | Use For |
|---|---|---|
SKILL.md | Entry point: scope, routing table, and workflow. | Start here. |
docs/prompt-guidance-openai-api-workflow-guide.md | A guide detailing strategies for improving model performance through preamble usage, outcome-first prompting, and formatting techniques. | Questions about a guide detailing strategies for improving model performance through preamble usage, outcome-first prompting, and for... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-migration.text | A text example demonstrating a prompt instruction to migrate a project to a newer model version. | Exact payloads, commands, or snippets shown in A text example demonstrating a prompt instruction to migrate a project to a newer model version. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-personality.text | A text example demonstrating how to use personality instructions within a prompt to guide model behavior. | Exact payloads, commands, or snippets shown in A text example demonstrating how to use personality instructions within a prompt to guide model behavior. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-personality-2.text | A text example demonstrating how to define a vivid and collaborative conversational personality within an OpenAI API prompt. | Exact payloads, commands, or snippets shown in A text example demonstrating how to define a vivid and collaborative conversational personality within an OpenAI API... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-multi-step-task-ac.text | A text example demonstrating how to provide short user-visible updates before executing tool calls in a multi-step task. | Exact payloads, commands, or snippets shown in A text example demonstrating how to provide short user-visible updates before executing tool calls in a multi-step task. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-tool-calling-instr.text | Text instructions demonstrating how to provide intermediary updates when using tool calling in OpenAI API prompts. | Exact payloads, commands, or snippets shown in Text instructions demonstrating how to provide intermediary updates when using tool calling in OpenAI API prompts. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-customer-issue-res.text | A text-based example demonstrating prompt guidance for resolving customer issues end-to-end using the OpenAI API. | Exact payloads, commands, or snippets shown in A text-based example demonstrating prompt guidance for resolving customer issues end-to-end using the OpenAI API. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-chain-of-thought.text | A text example demonstrating a multi-step reasoning prompt for inspecting and comparing data before tool calling. | Exact payloads, commands, or snippets shown in A text example demonstrating a multi-step reasoning prompt for inspecting and comparing data before tool calling. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-system-instruction.text | A system instruction text demonstrating how to guide model behavior for tool loop minimization and factual correctness. | Exact payloads, commands, or snippets shown in A system instruction text demonstrating how to guide model behavior for tool loop minimization and factual correctness. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance.text | A text example demonstrating prompt guidance techniques such as using minimum evidence and precise citations for the OpenAI API. | Exact payloads, commands, or snippets shown in A text example demonstrating prompt guidance techniques such as using minimum evidence and precise citations for the... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-formatting-example.text | Textual examples demonstrating effective use of formatting, headers, and lists for prompt comprehension in the OpenAI API. | Exact payloads, commands, or snippets shown in Textual examples demonstrating effective use of formatting, headers, and lists for prompt comprehension in the OpenAI... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-2.text | A text example demonstrating prompt engineering techniques such as persona setting, word count constraints, and structural prioritization for a senior business audience. | Exact payloads, commands, or snippets shown in A text example demonstrating prompt engineering techniques such as persona setting, word count constraints, and struc... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-instruction.text | A text-based example demonstrating prompt instructions for preserving artifact structure and improving clarity without adding new claims. | Exact payloads, commands, or snippets shown in A text-based example demonstrating prompt instructions for preserving artifact structure and improving clarity withou... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-qa-strategy.text | A text-based guide outlining strategies for optimizing search queries and retrieval calls for ordinary Q&A tasks. | Exact payloads, commands, or snippets shown in A text-based guide outlining strategies for optimizing search queries and retrieval calls for ordinary Q&A tasks. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-creative-generativ.text | Text examples demonstrating how to distinguish source-backed facts from creative wording in generative prompts. | Exact payloads, commands, or snippets shown in Text examples demonstrating how to distinguish source-backed facts from creative wording in generative prompts. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-3.text | A text-based example demonstrating prompt guidance principles for the OpenAI API. | Exact payloads, commands, or snippets shown in A text-based example demonstrating prompt guidance principles for the OpenAI API. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-artifact-rendering.text | A text-based instruction set for guiding an AI to render, inspect, and revise visual artifacts for layout and consistency. | Exact payloads, commands, or snippets shown in A text-based instruction set for guiding an AI to render, inspect, and revise visual artifacts for layout and consist... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-implementation-pla.text | A text example demonstrating how to structure implementation plans within a prompt for the OpenAI API. | Exact payloads, commands, or snippets shown in A text example demonstrating how to structure implementation plans within a prompt for the OpenAI API. |
examples/prompt-guidance-openai-api-openai-api-assistant-message-phase-replay.text | A text example demonstrating how to manually replay assistant items by preserving specific phase values like commentary and finalanswer. | Exact payloads, commands, or snippets shown in A text example demonstrating how to manually replay assistant items by preserving specific phase values like commenta... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-structure-template.text | A text template demonstrating the structural components of effective prompt guidance including role, personality, goal, success criteria, constraints, and output formatting. | Exact payloads, commands, or snippets shown in A text template demonstrating the structural components of effective prompt guidance including role, personality, goa... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-instructions.text | A set of structured instructions and formatting rules designed to guide model output behavior and constraints. | Exact payloads, commands, or snippets shown in A set of structured instructions and formatting rules designed to guide model output behavior and constraints. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-instructions-2.text | A set of instructional guidelines and decision logic for determining when to proceed with user intent versus when to ask for permission. | Exact payloads, commands, or snippets shown in A set of instructional guidelines and decision logic for determining when to proceed with user intent versus when to... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-principles.text | A text-based list of principles for managing instruction conflicts and safety constraints within OpenAI API prompts. | Exact payloads, commands, or snippets shown in A text-based list of principles for managing instruction conflicts and safety constraints within OpenAI API prompts. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-task-update.text | A text example demonstrating how to use task update instructions within a prompt to modify model behavior for a single response. | Exact payloads, commands, or snippets shown in A text example demonstrating how to use task update instructions within a prompt to modify model behavior for a singl... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-task-update-2.text | A text example demonstrating how to use structured task updates and specific rules within a prompt to guide model behavior. | Exact payloads, commands, or snippets shown in A text example demonstrating how to use structured task updates and specific rules within a prompt to guide model beh... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-best-practices.text | A text-based list of strategic guidelines for optimizing prompt performance and tool usage within the OpenAI API. | Exact payloads, commands, or snippets shown in A text-based list of strategic guidelines for optimizing prompt performance and tool usage within the OpenAI API. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-best-practices-2.text | A text-based list of strategic guidelines for structuring prompts to ensure prerequisite steps and dependencies are addressed. | Exact payloads, commands, or snippets shown in A text-based list of strategic guidelines for structuring prompts to ensure prerequisite steps and dependencies are a... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-best-practices-3.text | A list of strategic guidelines for optimizing prompt performance and managing parallel tool calls within the OpenAI API. | Exact payloads, commands, or snippets shown in A list of strategic guidelines for optimizing prompt performance and managing parallel tool calls within the OpenAI API. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-checklist-instruct.text | A text-based set of instructional guidelines for prompting models to ensure task completeness and checklist adherence. | Exact payloads, commands, or snippets shown in A text-based set of instructional guidelines for prompting models to ensure task completeness and checklist adherence. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-fallback-strategie.text | A text-based example demonstrating prompt instructions for handling empty or narrow lookup results using fallback strategies. | Exact payloads, commands, or snippets shown in A text-based example demonstrating prompt instructions for handling empty or narrow lookup results using fallback str... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-checklist.text | A checklist of criteria for verifying output correctness, grounding, formatting, and safety when using the OpenAI API. | Exact payloads, commands, or snippets shown in A checklist of criteria for verifying output correctness, grounding, formatting, and safety when using the OpenAI API. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-instructions-3.text | A set of text-based instructions and rules for guiding model behavior and handling missing context. | Exact payloads, commands, or snippets shown in A set of text-based instructions and rules for guiding model behavior and handling missing context. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-preflight-postflig.text | A text example demonstrating the pre-flight, execution, and post-flight structure for prompt guidance. | Exact payloads, commands, or snippets shown in A text example demonstrating the pre-flight, execution, and post-flight structure for prompt guidance. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-citation-instructi.text | A text-based set of instructions for guiding an LLM on how to correctly cite sources and avoid fabrication. | Exact payloads, commands, or snippets shown in A text-based set of instructions for guiding an LLM on how to correctly cite sources and avoid fabrication. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-instructions-4.text | A set of text-based instructions for guiding model behavior regarding context adherence, conflict resolution, and inference labeling. | Exact payloads, commands, or snippets shown in A set of text-based instructions for guiding model behavior regarding context adherence, conflict resolution, and inf... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-research-passes.text | A text example demonstrating a multi-pass research prompt structure for the OpenAI API. | Exact payloads, commands, or snippets shown in A text example demonstrating a multi-pass research prompt structure for the OpenAI API. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-structured-contrac.text | A text-based prompt instruction set for enforcing structured output formats and validation rules. | Exact payloads, commands, or snippets shown in A text-based prompt instruction set for enforcing structured output formats and validation rules. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-bbox-extraction-sp.text | A text specification defining coordinate formats and validation rules for bounding box extraction prompts. | Exact payloads, commands, or snippets shown in A text specification defining coordinate formats and validation rules for bounding box extraction prompts. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-system-instruction-2.text | A text-based example of system instructions for controlling model behavior and update frequency. | Exact payloads, commands, or snippets shown in A text-based example of system instructions for controlling model behavior and update frequency. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-4.text | A text-based example demonstrating prompt guidance techniques for the OpenAI API. | Exact payloads, commands, or snippets shown in A text-based example demonstrating prompt guidance techniques for the OpenAI API. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-5.text | A text-based example demonstrating prompt guidance techniques for communicating progress and updates to an AI model. | Exact payloads, commands, or snippets shown in A text-based example demonstrating prompt guidance techniques for communicating progress and updates to an AI model. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-formatting-rules.text | A text file outlining specific formatting constraints for prompts, such as avoiding nested bullets and using specific numbered list styles. | Exact payloads, commands, or snippets shown in A text file outlining specific formatting constraints for prompts, such as avoiding nested bullets and using specific... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-frontend-design-ru.text | A text-based set of hard rules and constraints for guiding an AI to perform frontend design tasks. | Exact payloads, commands, or snippets shown in A text-based set of hard rules and constraints for guiding an AI to perform frontend design tasks. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-system-instruction-3.text | A set of system instructions and constraints for guiding model behavior and tool usage within the OpenAI API. | Exact payloads, commands, or snippets shown in A set of system instructions and constraints for guiding model behavior and tool usage within the OpenAI API. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-coordinate-format.text | A text example demonstrating specific prompt instructions for coordinate formatting and bounding box requirements. | Exact payloads, commands, or snippets shown in A text example demonstrating specific prompt instructions for coordinate formatting and bounding box requirements. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-persona-formatting.text | A text-based example demonstrating prompt engineering techniques including persona, channel, emotional register, and formatting constraints. | Exact payloads, commands, or snippets shown in A text-based example demonstrating prompt engineering techniques including persona, channel, emotional register, and... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-best-practices-4.text | A list of instructional guidelines and stylistic constraints for optimizing prompt engineering within the OpenAI API. | Exact payloads, commands, or snippets shown in A list of instructional guidelines and stylistic constraints for optimizing prompt engineering within the OpenAI API. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-best-practices-5.text | A list of strategic instructions and reasoning techniques for improving model performance through effective prompt guidance. | Exact payloads, commands, or snippets shown in A list of strategic instructions and reasoning techniques for improving model performance through effective prompt gu... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-system-message.text | A text example demonstrating a system message for a coding agent persona using prompt guidance techniques. | Exact payloads, commands, or snippets shown in A text example demonstrating a system message for a coding agent persona using prompt guidance techniques. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-agents-md-instruct.text | A markdown file containing instructions for configuring AGENTS.md within a directory to follow prompt guidance principles. | Exact payloads, commands, or snippets shown in A markdown file containing instructions for configuring AGENTS.md within a directory to follow prompt guidance princi... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-examples.text | Text-based examples demonstrating various prompt engineering techniques and guidance strategies for the OpenAI API. | Exact payloads, commands, or snippets shown in Text-based examples demonstrating various prompt engineering techniques and guidance strategies for the OpenAI API. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-function-calling.text | A text example demonstrating prompt guidance techniques using a function calling schema for a shell command. | Exact payloads, commands, or snippets shown in A text example demonstrating prompt guidance techniques using a function calling schema for a shell command. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-shell-command-exec.text | An example demonstrating how to structure a prompt for a tool that runs shell commands via PowerShell and returns the output. | Exact payloads, commands, or snippets shown in An example demonstrating how to structure a prompt for a tool that runs shell commands via PowerShell and returns the... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-function-calling-2.text | A text example demonstrating function calling schema and tool definitions for prompt guidance within the OpenAI API. | Exact payloads, commands, or snippets shown in A text example demonstrating function calling schema and tool definitions for prompt guidance within the OpenAI API. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-function-calling-3.text | A text example demonstrating function calling parameters and schema definitions for prompt guidance within the OpenAI API. | Exact payloads, commands, or snippets shown in A text example demonstrating function calling parameters and schema definitions for prompt guidance within the OpenAI... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-function-calling-4.text | A text example demonstrating how to structure tool definitions for function calling within a prompt guidance context. | Exact payloads, commands, or snippets shown in A text example demonstrating how to structure tool definitions for function calling within a prompt guidance context. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-exploration-readin.text | Textual instructions and strategies for effective file exploration and batching during tool use within OpenAI API prompts. | Exact payloads, commands, or snippets shown in Textual instructions and strategies for effective file exploration and batching during tool use within OpenAI API pro... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-function-calling-5.text | A text example demonstrating prompt guidance techniques specifically for function calling within the OpenAI API. | Exact payloads, commands, or snippets shown in A text example demonstrating prompt guidance techniques specifically for function calling within the OpenAI API. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-personality-3.text | A text example demonstrating how to use personality and value instructions within a prompt for the OpenAI API. | Exact payloads, commands, or snippets shown in A text example demonstrating how to use personality and value instructions within a prompt for the OpenAI API. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-6.text | A text example demonstrating effective prompt guidance techniques for the OpenAI API. | Exact payloads, commands, or snippets shown in A text example demonstrating effective prompt guidance techniques for the OpenAI API. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-verbosity-spec.text | A text specification defining output verbosity guidelines and structural requirements for model responses. | Exact payloads, commands, or snippets shown in A text specification defining output verbosity guidelines and structural requirements for model responses. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-design-constraints.text | A text example demonstrating how to use design and scope constraints within a prompt to guide model output. | Exact payloads, commands, or snippets shown in A text example demonstrating how to use design and scope constraints within a prompt to guide model output. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-long-context-handl.text | A text example demonstrating strategies for handling long context inputs such as internal outlines and constraint re-statement. | Exact payloads, commands, or snippets shown in A text example demonstrating strategies for handling long context inputs such as internal outlines and constraint re-... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-uncertainty-ambigu.text | A text example demonstrating how to structure prompts to handle uncertainty and ambiguity by asking clarifying questions or presenting multiple interpretations. | Exact payloads, commands, or snippets shown in A text example demonstrating how to structure prompts to handle uncertainty and ambiguity by asking clarifying questi... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-self-check.text | A text example demonstrating how to use a high-risk self-check prompt to refine answers in sensitive contexts. | Exact payloads, commands, or snippets shown in A text example demonstrating how to use a high-risk self-check prompt to refine answers in sensitive contexts. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-compact-response-p.text | A text representation of a POST request to the OpenAI compact responses endpoint demonstrating prompt guidance techniques. | Exact payloads, commands, or snippets shown in A text representation of a POST request to the OpenAI compact responses endpoint demonstrating prompt guidance techni... |
examples/prompt-guidance-openai-api-openai-api-python-prompt-guidance.text | A Python script demonstrating how to use the OpenAI API to implement prompt guidance techniques. | Exact payloads, commands, or snippets shown in A Python script demonstrating how to use the OpenAI API to implement prompt guidance techniques. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-user-updates-spec.text | A text-based specification defining rules for sending brief user updates during task execution. | Exact payloads, commands, or snippets shown in A text-based specification defining rules for sending brief user updates during task execution. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-tool-usage-rules.text | A text-based example demonstrating structured tool usage rules and instructions for guiding model behavior within a prompt. | Exact payloads, commands, or snippets shown in A text-based example demonstrating structured tool usage rules and instructions for guiding model behavior within a p... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-extraction-spec.text | A text-based prompt template demonstrating structured data extraction instructions for converting unstructured text into a specific JSON schema. | Exact payloads, commands, or snippets shown in A text-based prompt template demonstrating structured data extraction instructions for converting unstructured text i... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-web-search-rules.text | A text-based example demonstrating how to use structured system instructions to guide an AI assistant's research behavior and citation requirements. | Exact payloads, commands, or snippets shown in A text-based example demonstrating how to use structured system instructions to guide an AI assistant's research beha... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-web-research-agent.text | A text-based system prompt defining the persona and operational guidelines for a web research agent. | Exact payloads, commands, or snippets shown in A text-based system prompt defining the persona and operational guidelines for a web research agent. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-persona.text | A text example demonstrating how to use persona-based instructions to guide model behavior and tone. | Exact payloads, commands, or snippets shown in A text example demonstrating how to use persona-based instructions to guide model behavior and tone. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-formatting-rules-2.text | A text file containing specific rules and constraints for enforcing final answer compactness and formatting in model responses. | Exact payloads, commands, or snippets shown in A text file containing specific rules and constraints for enforcing final answer compactness and formatting in model... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-verbosity-spec-2.text | A text example demonstrating how to use output verbosity specifications within a prompt to control response length and style. | Exact payloads, commands, or snippets shown in A text example demonstrating how to use output verbosity specifications within a prompt to control response length an... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-user-updates.text | A text example demonstrating how to provide periodic status updates to users during long-running tool execution sequences. | Exact payloads, commands, or snippets shown in A text example demonstrating how to provide periodic status updates to users during long-running tool execution seque... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-user-update-immedi.text | A text example demonstrating how to use prompt guidance to instruct a model to provide commentary before analysis thinking messages. | Exact payloads, commands, or snippets shown in A text example demonstrating how to use prompt guidance to instruct a model to provide commentary before analysis thi... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-persona-instructio.text | A text example demonstrating how to use persona instructions and solution persistence tags within an OpenAI API prompt. | Exact payloads, commands, or snippets shown in A text example demonstrating how to use persona instructions and solution persistence tags within an OpenAI API prompt. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-function-calling-6.text | A text example demonstrating how to use function calling descriptions within a prompt to guide model behavior. | Exact payloads, commands, or snippets shown in A text example demonstrating how to use function calling descriptions within a prompt to guide model behavior. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-reservation-tool-r.text | A text-based example demonstrating system prompt instructions for a reservation tool usage rule set. | Exact payloads, commands, or snippets shown in A text-based example demonstrating system prompt instructions for a reservation tool usage rule set. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-tool-call-parallel.text | An example demonstrating how to parallelize tool calls such as read_file and apply_patch to optimize API performance. | Exact payloads, commands, or snippets shown in An example demonstrating how to parallelize tool calls such as readfile and applypatch to optimize API performance. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-system-instruction-4.text | A text-based system instruction example demonstrating extensive planning and reflection strategies for OpenAI API function calling. | Exact payloads, commands, or snippets shown in A text-based system instruction example demonstrating extensive planning and reflection strategies for OpenAI API fun... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-replacement-varian.text | A text example demonstrating prompt guidance for selecting replacement variants based on user constraints like price and brand. | Exact payloads, commands, or snippets shown in A text example demonstrating prompt guidance for selecting replacement variants based on user constraints like price... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-agent-instruction.text | A text-based system instruction example demonstrating how to guide an AI agent to persist until a user's query is fully resolved. | Exact payloads, commands, or snippets shown in A text-based system instruction example demonstrating how to guide an AI agent to persist until a user's query is ful... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-plan-tool-usage.text | An example demonstrating how to structure a lightweight plan using the plan tool for medium or larger tasks within the OpenAI API prompt guidance. | Exact payloads, commands, or snippets shown in An example demonstrating how to structure a lightweight plan using the plan tool for medium or larger tasks within th... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-structured.text | A text example demonstrating structured output formatting for a task update plan using JSON schema. | Exact payloads, commands, or snippets shown in A text example demonstrating structured output formatting for a task update plan using JSON schema. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-design-system-enfo.text | A text example demonstrating how to use prompt guidance to enforce design system token usage instead of hard-coded color values. | Exact payloads, commands, or snippets shown in A text example demonstrating how to use prompt guidance to enforce design system token usage instead of hard-coded co... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-python-response-cr.text | A Python code example demonstrating how to use the client.responses.create method with specific model inputs and tools for prompt guidance. | Exact payloads, commands, or snippets shown in A Python code example demonstrating how to use the client.responses.create method with specific model inputs and tool... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-patch-call.text | A JSON object demonstrating an applypatchcall operation used to update a file via a diff within the OpenAI API. | Exact payloads, commands, or snippets shown in A JSON object demonstrating an applypatchcall operation used to update a file via a diff within the OpenAI API. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-examples-2.text | Textual examples demonstrating effective prompt engineering techniques for the OpenAI API. | Exact payloads, commands, or snippets shown in Textual examples demonstrating effective prompt engineering techniques for the OpenAI API. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-tool-definition.text | A text example demonstrating how to define tool structures within a prompt for the OpenAI API. | Exact payloads, commands, or snippets shown in A text example demonstrating how to define tool structures within a prompt for the OpenAI API. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-examples-3.text | Textual examples demonstrating effective prompt engineering techniques for the OpenAI API. | Exact payloads, commands, or snippets shown in Textual examples demonstrating effective prompt engineering techniques for the OpenAI API. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-shell-call.text | A shell call output object demonstrating the structure of a response containing stdout, stderr, and exit code information. | Exact payloads, commands, or snippets shown in A shell call output object demonstrating the structure of a response containing stdout, stderr, and exit code informa... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-greengather-agent-.text | A text-based example of a system prompt defining the persona and objectives for the GreenGather sustainable event-planning agent. | Exact payloads, commands, or snippets shown in A text-based example of a system prompt defining the persona and objectives for the GreenGather sustainable event-pla... |
examples/prompt-guidance-openai-api-openai-api-prompt-engineering-event-planner-d.text | A text-based scenario where a prompt engineer debugs a system prompt for an event-planning agent using logged tool failures. | Exact payloads, commands, or snippets shown in A text-based scenario where a prompt engineer debugs a system prompt for an event-planning agent using logged tool fa... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-system-prompt-revi.text | A text-based example demonstrating how to provide a system prompt and failure-mode analysis to request a surgical revision of the prompt. | Exact payloads, commands, or snippets shown in A text-based example demonstrating how to provide a system prompt and failure-mode analysis to request a surgical rev... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-patch-notes.text | A list of recent updates and clarifications regarding prompt guidance rules for concision and detail. | Exact payloads, commands, or snippets shown in A list of recent updates and clarifications regarding prompt guidance rules for concision and detail. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-context-gathering.text | A text-based example demonstrating the context gathering strategy for effective prompt guidance using the OpenAI API. | Exact payloads, commands, or snippets shown in A text-based example demonstrating the context gathering strategy for effective prompt guidance using the OpenAI API. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-7.text | A text-based example demonstrating prompt guidance techniques for the OpenAI API. | Exact payloads, commands, or snippets shown in A text-based example demonstrating prompt guidance techniques for the OpenAI API. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-persistence.text | A text example demonstrating how to use persistence instructions within a prompt to guide agent behavior. | Exact payloads, commands, or snippets shown in A text example demonstrating how to use persistence instructions within a prompt to guide agent behavior. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-tool-preamble.text | A text example demonstrating how to structure tool preambles and step-by-step narration instructions for the OpenAI API. | Exact payloads, commands, or snippets shown in A text example demonstrating how to structure tool preambles and step-by-step narration instructions for the OpenAI API. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-reasoning.text | A text representation of an OpenAI API response demonstrating structured reasoning and message output formats. | Exact payloads, commands, or snippets shown in A text representation of an OpenAI API response demonstrating structured reasoning and message output formats. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-self-reflection.text | A text example demonstrating the use of self-reflection techniques within a prompt to improve output quality. | Exact payloads, commands, or snippets shown in A text example demonstrating the use of self-reflection techniques within a prompt to improve output quality. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-editing-rules.text | A text file containing specific code editing rules and structural guidelines for prompt engineering. | Exact payloads, commands, or snippets shown in A text file containing specific code editing rules and structural guidelines for prompt engineering. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-best-practices-6.text | A text file outlining best practices for writing clear, maintainable, and high-verbosity code and prompts for the OpenAI API. | Exact payloads, commands, or snippets shown in A text file outlining best practices for writing clear, maintainable, and high-verbosity code and prompts for the Ope... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-best-practices-7.text | A text document outlining best practices and considerations for effective prompt guidance within the OpenAI API. | Exact payloads, commands, or snippets shown in A text document outlining best practices and considerations for effective prompt guidance within the OpenAI API. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-maximize-context-u.text | A text example demonstrating the use of the maximize_context_understanding instruction for prompt guidance in the OpenAI API. | Exact payloads, commands, or snippets shown in A text example demonstrating the use of the maximizecontextunderstanding instruction for prompt guidance in the OpenA... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-context-understand.text | A text example demonstrating how to use context understanding and tool usage instructions within a prompt for the OpenAI API. | Exact payloads, commands, or snippets shown in A text example demonstrating how to use context understanding and tool usage instructions within a prompt for the Ope... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-healthcare-assista.text | A system prompt example defining a healthcare virtual assistant persona for patient triage and scheduling. | Exact payloads, commands, or snippets shown in A system prompt example defining a healthcare virtual assistant persona for patient triage and scheduling. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-agentic-instructio.text | A text example demonstrating agentic prompting instructions to ensure complete task decomposition and resolution. | Exact payloads, commands, or snippets shown in A text example demonstrating agentic prompting instructions to ensure complete task decomposition and resolution. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-markdown-formattin.text | A text file outlining semantic markdown usage and mathematical notation rules for structuring assistant messages in OpenAI API prompts. | Exact payloads, commands, or snippets shown in A text file outlining semantic markdown usage and mathematical notation rules for structuring assistant messages in O... |
examples/prompt-guidance-openai-api-openai-api-prompt-optimization-guidance.text | A text example demonstrating how to instruct an AI to optimize prompts by analyzing specific phrases to elicit desired behaviors. | Exact payloads, commands, or snippets shown in A text example demonstrating how to instruct an AI to optimize prompts by analyzing specific phrases to elicit desire... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-examples-4.text | Textual examples demonstrating effective prompt engineering techniques for the OpenAI API. | Exact payloads, commands, or snippets shown in Textual examples demonstrating effective prompt engineering techniques for the OpenAI API. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-function-calling-e.text | Text examples demonstrating prompt guidance techniques for function calling within the OpenAI API. | Exact payloads, commands, or snippets shown in Text examples demonstrating prompt guidance techniques for function calling within the OpenAI API. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-retail-agent-syste.text | A system message example for a retail agent persona designed to guide model behavior for order management and user assistance. | Exact payloads, commands, or snippets shown in A system message example for a retail agent persona designed to guide model behavior for order management and user as... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-coding-agent-syste.text | A system instruction text file defining persona and operational constraints for a deployed coding agent using the OpenAI API. | Exact payloads, commands, or snippets shown in A system instruction text file defining persona and operational constraints for a deployed coding agent using the Ope... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-agent-persona.text | A text example demonstrating how to use system instructions to define an agentic persona that persists until a task is resolved. | Exact payloads, commands, or snippets shown in A text example demonstrating how to use system instructions to define an agentic persona that persists until a task i... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-examples-5.text | Textual examples demonstrating best practices for prompt guidance within the OpenAI API. | Exact payloads, commands, or snippets shown in Textual examples demonstrating best practices for prompt guidance within the OpenAI API. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-planning-reflectio.text | A text example demonstrating prompt guidance techniques for extensive planning and reflection before and after function calls. | Exact payloads, commands, or snippets shown in A text example demonstrating prompt guidance techniques for extensive planning and reflection before and after functi... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-examples-6.text | Text-based examples demonstrating various prompt engineering techniques and guidance strategies for the OpenAI API. | Exact payloads, commands, or snippets shown in Text-based examples demonstrating various prompt engineering techniques and guidance strategies for the OpenAI API. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-8.text | A text-based example demonstrating effective prompt guidance techniques for the OpenAI API. | Exact payloads, commands, or snippets shown in A text-based example demonstrating effective prompt guidance techniques for the OpenAI API. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-instructions-5.text | A text example demonstrating how to structure system instructions for grounding model responses in provided external context. | Exact payloads, commands, or snippets shown in A text example demonstrating how to structure system instructions for grounding model responses in provided external... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-step-by-step-reaso.text | A text example demonstrating how to use step-by-step reasoning instructions to guide an LLM in document retrieval and formatting tasks. | Exact payloads, commands, or snippets shown in A text example demonstrating how to use step-by-step reasoning instructions to guide an LLM in document retrieval and... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-reasoning-strategy.text | A text-based guide outlining reasoning strategies for effective prompt engineering within the OpenAI API. | Exact payloads, commands, or snippets shown in A text-based guide outlining reasoning strategies for effective prompt engineering within the OpenAI API. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-system-message-2.text | A text example demonstrating the use of a system message to define a persona and instructions for the OpenAI API. | Exact payloads, commands, or snippets shown in A text example demonstrating the use of a system message to define a persona and instructions for the OpenAI API. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-chat-message.text | A text representation of a structured chat message exchange demonstrating prompt guidance techniques for an AI assistant. | Exact payloads, commands, or snippets shown in A text representation of a structured chat message exchange demonstrating prompt guidance techniques for an AI assist... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-role-objective-rea.text | A text example demonstrating prompt guidance techniques including role definition, reasoning steps, and output formatting for the OpenAI API. | Exact payloads, commands, or snippets shown in A text example demonstrating prompt guidance techniques including role definition, reasoning steps, and output format... |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-examples-7.text | A collection of text-based examples demonstrating effective prompt guidance techniques for the OpenAI API. | Exact payloads, commands, or snippets shown in A collection of text-based examples demonstrating effective prompt guidance techniques for the OpenAI API. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-best-practices-8.text | A text-based guide outlining strategies and principles for effective prompt engineering with the OpenAI API. | Exact payloads, commands, or snippets shown in A text-based guide outlining strategies and principles for effective prompt engineering with the OpenAI API. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-examples-8.text | Text-based examples demonstrating various prompt engineering techniques and guidance strategies for the OpenAI API. | Exact payloads, commands, or snippets shown in Text-based examples demonstrating various prompt engineering techniques and guidance strategies for the OpenAI API. |
examples/prompt-guidance-openai-api-openai-api-prompt-guidance-diff-examples.text | Text examples demonstrating search-replace and pseudo-xml diff formats for prompt guidance. | Exact payloads, commands, or snippets shown in Text examples demonstrating search-replace and pseudo-xml diff formats for prompt guidance. |
What This Skill Covers
- Personality Adopt a vivid conversational presence: intelligent, curious, playful when appropriate, and attentive to the user's thinking. Ask good questions w...
- Main sections:
Improve time to first visible token with a preamble,Outcome-first prompts and stopping conditions,Formatting,Grounding, citations, and retrieval budgets,Add an explicit retrieval budget.
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/prompt-guidance