OpenAI Codex¶
Validates OpenAI's optional skill metadata in agents/openai.yaml, plus Codex plugins and marketplaces against the Codex plugin specification. The metadata rule auto-enables for Agent Skills; the plugin and marketplace rules auto-enable only when their Codex manifests are present. Project .codex/config.toml files also get a warning when an HTTP MCP server uses the ignored headers field instead of Codex's http_headers.
| Rule ID | Description | Default Severity | Autofix |
|---|---|---|---|
codex-hooks-valid |
Codex hooks files must use Codex's hook events, handler types, and fields | error (auto) | - |
codex-mcp-headers |
Codex HTTP MCP servers must use http_headers instead of ignored headers | warning (auto) | - |
codex-openai-metadata |
Validate skill openai.yaml and catalog-compatible plugin metadata | error (auto) | - |
codex-plugin-json-valid |
The selected Codex manifest or portable OpenAI overlay must be valid | error (auto) | - |
codex-plugin-structure |
Only plugin.json belongs in .codex-plugin/ | warning (auto) | - |
codex-marketplace-json-valid |
.agents/plugins/marketplace.json must be valid JSON with required fields | error (auto) | - |
codex-marketplace-registration |
Codex plugins must be registered in .agents/plugins/marketplace.json | error (auto) | auto |