Files
Bharath Natarajan 54fada6741 Fix OpenAI plugin submission errors for the auth0 plugin (#193)
* 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.
2026-08-31 13:22:06 +05:30
..