Vaibhav SrivastavandGitHub a8924c2a35 [codex] Mirror Codex self-knowledge updates in OpenAI docs (#454)
## 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
2026-05-29 17:20:38 +01:00

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.

S
Description
No description provided
Readme
9.5 MiB
Languages
Python 78.1%
JavaScript 16.8%
Shell 2.2%
Jupyter Notebook 1%
Swift 1%
Other 0.9%