Bharath Natarajan
54fada6741
* 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.
1.9 KiB
OpenAI / Codex plugin
This repository packages the unified auth0 skill as a skills-only OpenAI
plugin. ChatGPT and Codex use the same universal plugin format and directory.
Package layout
plugins/auth0/
├── .codex-plugin/
│ └── plugin.json
└── skills/
└── auth0/
├── SKILL.md
└── agents/
└── openai.yaml
The canonical skill content is shared with the Claude and Cursor packages; do not create a Codex-specific copy of the skill.
Testing before submission
The repository includes an OpenAI-compatible marketplace at:
.agents/plugins/marketplace.json
Add that marketplace in the ChatGPT desktop or Codex Plugins UI, install Auth0, restart the host if necessary, and test in a new conversation. Test direct and indirect authentication requests, framework routing, reference loading, and negative requests that should not activate the skill.
The entry resolves plugins/auth0 from the published main branch, so push
your changes before reinstalling — an uncommitted working tree is not what gets
installed.
For Codex CLI, inspect configured marketplaces with:
codex plugin marketplace list
codex plugin marketplace upgrade
Public publication
A manifest and repository marketplace do not publish the plugin. To list Auth0 in the universal ChatGPT and Codex directory:
- Open the OpenAI plugin submission portal.
- Create a Skills only submission.
- Upload the tested
plugins/auth0bundle. - Provide Auth0 listing, legal, support, and brand metadata.
- Add starter prompts and five positive plus three negative test cases.
- Submit for review and publish after approval.
The OpenAI submission requires a verified developer or business identity and Apps Management write access for the submitting organization.