[skill-feedback] openai-docs blocks current official Codex docs redirect

Open Beginner friendly
#37,119 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
65/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Quiet
Domain
documentation

Research direction

Start at the openai-docs skill's web-fallback allowlist and inspect how redirects are validated. Reproduce the redirect from developers.openai.com/codex/hooks, then run or add the skill's regression coverage to verify it reaches learn.chatgpt.com without permitting non-OpenAI sources.

Written by the indexing model from the issue text.

Description

bug skills
Affected plugin / skill
  • Plugin: system openai-docs
  • Skill: openai-docs
  • Mislead likelihood: high
Expected behavior

The skill should permit official OpenAI documentation redirects when its local documentation lookup falls back to the web. In particular, an official developers.openai.com Codex documentation URL that redirects to another current first-party OpenAI documentation host should remain usable.

Actual behavior

The installed skill's fallback allowlist permits only developers.openai.com and platform.openai.com. The official Codex hooks URL now redirects to learn.chatgpt.com, so following the current official documentation path conflicts with the skill's own domain restriction.

Exact receipt

Against the current public endpoint on 2026-08-05:

$ curl -sSIL https://developers.openai.com/codex/hooks
HTTP/2 308
location: https://learn.chatgpt.com/docs/hooks

HTTP/2 200
content-type: text/html; charset=utf-8

The installed openai-docs skill does not include learn.chatgpt.com in its allowed fallback domains.

Smallest plausible fix

Update the skill's first-party web-fallback policy to accept the current official Codex documentation host, or define a redirect-aware first-party allowlist sourced from the current OpenAI documentation routing contract. Add a regression case that begins at the official developers.openai.com/codex/hooks URL and successfully follows the redirect without broadening fallback to non-OpenAI sources.

Dominant language
Rust
Stars
125k
Forks
19.5k
Avg merge
1m
Merged PRs (30d)
1k

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from openai/codex

All issues in openai/codex

Similar issues

More Rust issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.