From 972cb867affac58fda9afa76bb1a19b399a278cf Mon Sep 17 00:00:00 2001 From: Konstantine Kahadze Date: Wed, 17 Jun 2026 12:15:37 -0700 Subject: [PATCH] [codex] Mirror compact OpenAI docs search guidance (#494) ## Summary Mirrors [openai/codex#28389](https://github.com/openai/codex/pull/28389) into the system and curated OpenAI Docs skills. The compact search guidance performs better in Codex. ## Validation - Both skill validations passed - `git diff --check` --- skills/.curated/openai-docs/SKILL.md | 2 +- skills/.system/openai-docs/SKILL.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/skills/.curated/openai-docs/SKILL.md b/skills/.curated/openai-docs/SKILL.md index 926d0ec..ec6a2b0 100644 --- a/skills/.curated/openai-docs/SKILL.md +++ b/skills/.curated/openai-docs/SKILL.md @@ -129,7 +129,7 @@ If MCP tools fail or no OpenAI docs resources are available: 5. Leave historical docs, examples, eval baselines, fixtures, provider comparisons, provider registries, pricing tables, alias defaults, low-cost fallback paths, and ambiguous older model usage unchanged unless the user explicitly asks to upgrade them. 6. Keep SDK, tooling, IDE, plugin, shell, auth, and provider-environment migrations out of a model-and-prompt upgrade unless the user explicitly asks for them. 7. If an upgrade needs API-surface changes, schema rewiring, tool-handler changes, or implementation work beyond a literal model-string replacement and prompt edits, report it as blocked or confirmation-needed. -8. For general docs lookup, search docs with a precise query, fetch the best page and exact section needed, and answer with concise citations. +8. For general docs lookup, start with a compact, title-like search query of 2-6 essential terms. Do not turn the full user question into a keyword list. Fetch the best page and exact section needed, and answer with concise citations. ## Reference map diff --git a/skills/.system/openai-docs/SKILL.md b/skills/.system/openai-docs/SKILL.md index 30526bd..df395fb 100644 --- a/skills/.system/openai-docs/SKILL.md +++ b/skills/.system/openai-docs/SKILL.md @@ -135,7 +135,7 @@ If MCP tools fail or no OpenAI docs resources are available: 5. Leave historical docs, examples, eval baselines, fixtures, provider comparisons, provider registries, pricing tables, alias defaults, low-cost fallback paths, and ambiguous older model usage unchanged unless the user explicitly asks to upgrade them. 6. Keep SDK, tooling, IDE, plugin, shell, auth, and provider-environment migrations out of a model-and-prompt upgrade unless the user explicitly asks for them. 7. If an upgrade needs API-surface changes, schema rewiring, tool-handler changes, or implementation work beyond a literal model-string replacement and prompt edits, report it as blocked or confirmation-needed. -8. For general docs lookup, search docs with a precise query, fetch the best page and exact section needed, and answer with concise citations. +8. For general docs lookup, start with a compact, title-like search query of 2-6 essential terms. Do not turn the full user question into a keyword list. Fetch the best page and exact section needed, and answer with concise citations. ## Reference map