Open Source docs point to the deprecated skills repo and overstate codex-universal parity
Open 💬 0 comments Opened Aug 23, 2026 by ShawnSiao
What is the type of issue?
Documentation is incorrect
What is the issue?
What is the type of issue?
- Documentation is incorrect
What is the issue?
The Open Source documentation currently has two rows that do not match the repositories they link to:
- The Skills row points to
openai/skillsand describes it as the location for reusable skills. The repository README now marks that repository as deprecated and directs current Codex skill and plugin examples toopenai/plugins. - The Universal cloud environment row describes
openai/codex-universalas the base environment used by Codex cloud. Its README describes the image as a reference implementation that is similar to, but not identical to, the Codex environment and intended for approximation and local debugging.
Sources:
- Open Source page: https://learn.chatgpt.com/docs/open-source
- Deprecated skills notice: https://github.com/openai/skills#readme
- codex-universal scope: https://github.com/openai/codex-universal#readme
Suggested wording
- Skills: "Deprecated archive of skill examples; current skill and plugin examples live in
openai/plugins." - Universal cloud environment: "Reference implementation that approximates the Codex cloud base environment; it is not identical to the hosted environment."
Alternatively, the Skills row could be removed if Plugins is now the sole current distribution repository.
Why this matters
The current wording can send prospective contributors to a deprecated repository and can lead developers to expect exact parity from codex-universal when debugging environment differences.
I searched open and closed Issues and PRs in openai/codex, plus the related openai/skills and openai/codex-universal issue trackers, using the repository names and the phrases open source, deprecated, universal cloud environment, and reference implementation. I did not find an existing report for these two rows.