<!-- Generated by scripts/generate-site-content.py — do not edit by hand -->


# OpenAI Codex

Validates OpenAI's optional [skill metadata](https://learn.chatgpt.com/docs/build-skills#optional-metadata) in `agents/openai.yaml`, plus Codex plugins and marketplaces against the [Codex plugin specification](https://developers.openai.com/plugins/build/plugins). The metadata rule auto-enables for Agent Skills; the plugin and marketplace rules auto-enable only when their Codex manifests are present.

| Rule ID | Description | Default Severity | Autofix |
|---------|-------------|------------------|---------|
| [`codex-hooks-valid`](codex-hooks-valid.md) | Codex hooks files must use Codex's hook events, handler types, and fields | error (auto) | - |
| [`codex-openai-metadata`](codex-openai-metadata.md) | Validate skill openai.yaml and catalog-compatible plugin metadata | error (auto) | - |
| [`codex-plugin-json-valid`](codex-plugin-json-valid.md) | .codex-plugin/plugin.json must be valid JSON with required fields | error (auto) | - |
| [`codex-plugin-structure`](codex-plugin-structure.md) | Only plugin.json belongs in .codex-plugin/ | warning (auto) | - |
| [`codex-marketplace-json-valid`](codex-marketplace-json-valid.md) | .agents/plugins/marketplace.json must be valid JSON with required fields | error (auto) | - |
| [`codex-marketplace-registration`](codex-marketplace-registration.md) | Codex plugins must be registered in .agents/plugins/marketplace.json | error (auto) | auto |