## Summary - mirror the OpenAI docs skill changes from [openai/codex#24914](https://github.com/openai/codex/pull/24914) into both the system and curated `openai-docs` copies - add Codex self-knowledge routing, manual-first lookup guidance, and updated skill metadata - add the cached Codex manual fetch helper with temp-cache auto-discovery and hash verification ## Why The standalone skills repository should ship the same Codex-aware OpenAI docs behavior already merged into the Codex bundled skill while preserving the existing `.system` and `.curated` distinction. ## Impact OpenAI docs lookups can now route broad Codex questions through the current Codex manual before using Docs MCP fallback. The helper works without requiring an explicit `--cache-dir` override. ## Validation - `git diff --check` - `node --check skills/.curated/openai-docs/scripts/fetch-codex-manual.mjs` - `node --check skills/.system/openai-docs/scripts/fetch-codex-manual.mjs` - live `curl -fsSI https://developers.openai.com/codex/codex-manual.md` verification returned `x-content-sha256` - helper smoke test without `--cache-dir`: fresh fetch returned `cacheStatus: "updated"`, second run returned `cacheStatus: "hit"` - exact helper and agent metadata comparison across `.system` and `.curated` copies
Agent Skills
Agent Skills are folders of instructions, scripts, and resources that AI agents can discover and use to perform at specific tasks. Write once, use everywhere.
Codex uses skills to help package capabilities that teams and individuals can use to complete specific tasks in a repeatable way. This repository catalogs skills for use and distribution with Codex.
Learn more:
Installing a skill
Skills in .system are automatically installed in the latest version of Codex.
To install curated or experimental skills, you can use the $skill-installer inside Codex.
Curated skills can be installed by name (defaults to skills/.curated):
$skill-installer gh-address-comments
For experimental skills, specify the skill folder. For example:
$skill-installer install the create-plan skill from the .experimental folder
Or provide the GitHub directory URL:
$skill-installer install https://github.com/openai/skills/tree/main/skills/.experimental/create-plan
After installing a skill, restart Codex to pick up new skills.
License
The license of an individual skill can be found directly inside the skill's directory inside the LICENSE.txt file.