agentleFS
Sign inStart free
lyh843lyh843/AgentSkills/skills/openai-docs/SKILL.md

openai-docs

Skill1 starsChanged 5 months agoMITView on GitHub

Use for Codex models/pricing, scheduled tasks, skills, settings, setup, troubleshooting, customization, automations, and self-knowledge—including 'you,' 'your,' 'this app,' or 'this coding agent' when they refer to Codex—and for OpenAI APIs/products and ChatGPT Work. Also use for model choice/migration, prompting, SDKs, Responses, Realtime, agents, evals, and Chat/Work/Codex comparisons. Do not use for generic app/software tasks that merely mention Codex.

We split this skill into the rules it gives an agent

8 rules. 0 are common, 5 are distinctive, and 3 are very specific to this project.

  • 0

    Common

    Most of the 27 edited versions we read keep these.

  • 5

    Distinctive

    This author's own choices. Worth a look.

  • 3

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use the first matching route, and read its reference only when the requested task needs that specialized workflow:

    line 22
  2. Distinctive:

    Explicitly requested local documentation integration: Read integration guidance only when the user explicitly requests that local …

    line 24
  3. Distinctive:

    Model migration, upgrades, or model-specific prompting: Read model-migration.md for actual migration planning, implementation, dynamic …

    line 25
  4. Distinctive:

    Model selection and comparisons: Read model-selection.md only when nuanced current, latest, default, cost, latency, quality, or modality …

    line 26
  5. Distinctive:

    Read at most one primary reference.

    line 30
  6. Very specific:

    Search, open, fetch, and cite only developers.openai.com, platform.openai.com, and learn.chatgpt.com.

    line 34
  7. Very specific:

    Use references/latest-model.md only as a disclosed fallback after current official model guidance does not answer the question.

    line 36
  8. Very specific:

    Before building, running, editing, debugging, or testing an API-backed app or tool, use openai-platform-api-key first when available.

    line 37

“Common” is measured: kept by at least 6 in 10 of the 27 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

OpenAI Docs

Provide current, cited OpenAI product, API, model, and Codex guidance. Read zero or one primary reference.

First substantive action: Search the user's exact requested official OpenAI documentation topic and any explicitly named model using a concise, topic-specific query of 2-6 essential terms. When an already-available direct official documentation search and page-retrieval capability is present, use it first: search, then fetch or open the matching official page before general web search. Otherwise, immediately use official-domain web search, then actually open or fetch the relevant official page. Complete this source order before reading a reference, inspecting local or repository files, running a Codex manual or model resolver, drafting a plan, or answering from memory. Use the actual fetched page, not a search snippet or an unopened link. If one official search or page does not establish the answer, search another appropriate official domain and actually open or fetch the result. Preserve the exact requested model; never substitute a newer model.

Only exception: An explicitly requested, genuinely broad, cross-topic Codex setup, orientation, or system-map synthesis may use the manual first when shell execution and an allowed temporary cache are available. A specific Codex feature, setting, command, error, model, or requested citation remains docs-first. Mixed Chat/Work/Codex comparisons are official documentation questions, not manual-first Codex requests.

For generic software tasks, answer the software task directly. OpenAI implementation, debugging, SDK, API, prompting, agent, and eval requests are not generic.

For a straightforward factual or citation-only request, follow the source order and do not read a route reference. This includes straightforward API facts, ChatGPT Work or mixed Chat/Work/Codex comparisons, model tiers, aliases, Pro mode, reasoning settings, factual migration baselines, and narrow Codex facts. Prioritize learn.chatgpt.com for ChatGPT Work.

Choose one primary route

Use the first matching route, and read its reference only when the requested task needs that specialized workflow:

  • Explicitly requested local documentation integration: Read integration guidance only when the user explicitly requests that local integration.
  • Model migration, upgrades, or model-specific prompting: Read model-migration.md for actual migration planning, implementation, dynamic target resolution, or prompt changes. Preserve an explicitly requested target.
  • Model selection and comparisons: Read model-selection.md only when nuanced current, latest, default, cost, latency, quality, or modality tradeoffs need more guidance. Do not run a migration resolver for selection alone.
  • Product, API, ChatGPT Work, and mixed Chat/Work/Codex documentation: Read official-docs.md only when fetched official pages leave source selection, API schemas, or the requested implementation unresolved. This route is not manual-first.
  • Explicitly broad Codex setup, orientation, or cross-topic synthesis: Read codex-self-knowledge.md when the eligible Codex manual or deeper Codex procedures are needed.

Read at most one primary reference. Do not open every route, bundled model guide, or helper script. Read a supporting reference or run a helper only when the chosen workflow demonstrably needs it.

Source and execution boundaries

  • Search, open, fetch, and cite only developers.openai.com, platform.openai.com, and learn.chatgpt.com. Cite the page that supports the claim. State uncertainty when official sources do not establish pricing, availability, account access, limits, or behavior.
  • Preserve an explicitly requested model for selection, migration, and prompting. Resolve an unspecified latest or current migration target only after searching and fetching current official guidance.
  • Use references/latest-model.md only as a disclosed fallback after current official model guidance does not answer the question. Read references/upgrading-to-gpt-6-astra.md only for an actual, requested GPT-6 migration; read references/prompting-guide.md only for requested prompting work.
  • Before building, running, editing, debugging, or testing an API-backed app or tool, use openai-platform-api-key first when available. Documentation, conceptual examples, model selection, and read-only guidance do not require an API key.
  • Say "OpenAI Docs" or "official OpenAI documentation" in user-facing answers. Keep exact official citations and examples concise.

Download now (ZIP)

Trending

Steady: 0 new projects took it in the last 4 weeks, none the 4 weeks before.thin data

Week of Aug 30: 0 new projectsWeek of Sep 6: 0 new projectsWeek of Sep 13: 0 new projectsWeek of Sep 20: 0 new projectsWeek of Sep 27: 0 new projectsWeek of Oct 4: 0 new projectsWeek of Oct 11: 0 new projectsWeek of Oct 18: 0 new projects
Aug 2026Sep 2026Oct 2026
New projects taking a version of this file each week, over the 8 weeks our latest run read: only 0 in all, so this is a hint, not a trend.

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

Check your setup, free