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

Open 💬 0 comments Opened Aug 5, 2026 by t1mmen

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.

View original on GitHub ↗