* Fix OpenAI plugin submission errors for the auth0 plugin
- Codex interface category was "Developer tools" (lowercase "tools"),
but OpenAI's Agent Plugins schema requires the exact enum value
"Developer Tools" — fixes the "Unsupported plugin category" error.
- Add plugins/auth0/skills/auth0/agents/openai.yaml with the skill's
interface config (display_name, short_description, default_prompt),
since OpenAI's submission checker doesn't read interface settings
from SKILL.md metadata — fixes "Skill interface settings must use
agents/openai.yaml".
- Allow an agents/ directory in skill roots in the custom
skill-directory-structure skillsaw rule, since that's where the
Agent Plugins spec expects per-skill client config to live.
* Address review comments
- Fix the same category casing bug in .agents/plugins/marketplace.json
(CodeRabbit caught this second occurrence; the earlier fix only
covered plugins/auth0/.codex-plugin/plugin.json).
- Make SkillDirectoryStructureRule.ALLOWED_DIRS a frozenset so it can't
be mutated across instances (CodeRabbit).
- Exempt agents/openai.yaml from the agentskill-unreferenced-files
check, same as the existing scripts/validate-skill.sh exemption —
it's Codex-facing config, not router-linked content (skillsaw CI).
* Use reviewer-suggested short_description for the Codex interface
More specific than the placeholder — names the concrete capabilities
(MFA, SSO, RBAC, Organizations, custom domains, Universal Login) and
framework breadth instead of a generic one-liner.
* Add agents/openai.yaml to the docs/openai-plugin.md package layout tree
The Package layout diagram still only showed SKILL.md, so it no longer
matched what the plugin ships now.
* feat: package Auth0 skill for Codex plugins
* fix: use Auth0 marketplace display name
* docs: address review feedback on the Codex packaging
The Codex manifest carried a generic one-liner while the Claude and Cursor
manifests list the frameworks and features, so directory search for "Next.js"
or "MFA" would not have matched this listing. Reuse the marketplace copy for
both `description` and `interface.longDescription`.
Also drop the "Method N" numbering now that there are four install paths and
the newest one sat above the recommended path, sort `.agents/` into the
directory tree, and list both docs/ files in the tree and in AGENTS.md.
* docs: describe the Codex marketplace as tracking main, not local
The marketplace entry resolves plugins/auth0 from the published main branch, so
calling it "local testing" was wrong — an uncommitted working tree is not what
gets installed. Reword the four places that claimed it and note that changes
need pushing before reinstalling.
---------
Co-authored-by: Subhankar Maiti <35273200+subhankarmaiti@users.noreply.github.com>
Co-authored-by: Subhankar Maiti <subhankar.maiti@okta.com>
Bharath Natarajan