heygen@openai-curated ships SKILL.md descriptions longer than 1024 characters

Resolved 💬 2 comments Opened Jun 8, 2026 by Toshi3886 Closed Jun 8, 2026

Summary

heygen@openai-curated currently ships two SKILL.md files whose YAML frontmatter description fields exceed the Agent Skills / Codex loader limit of 1024 characters.

This is not a request to relax the loader limit. The loader behavior matches the existing public limit; the issue is that an OpenAI-curated plugin is distributed with skill metadata that Codex CLI rejects.

Environment

  • Codex CLI: 0.137.0
  • Platform: Windows / PowerShell
  • Plugin: heygen@openai-curated
  • OpenAI-curated cache version observed by codex plugin list: cd0fccd4
  • Skill frontmatter version observed locally: 3.1.0 # x-release-please-version

Warning

On Codex CLI startup / skill loading:

⚠ Skipped loading 2 skill(s) due to invalid SKILL.md files.

⚠ %USERPROFILE%\.codex\plugins\cache\openai-curated\heygen\cd0fccd4\skills\heygen-avatar\SKILL.md: invalid
  description: exceeds maximum length of 1024 characters

⚠ %USERPROFILE%\.codex\plugins\cache\openai-curated\heygen\cd0fccd4\skills\heygen-video\SKILL.md: invalid description:
  exceeds maximum length of 1024 characters

Measured locally

  • heygen-avatar description length: 1388 characters
  • heygen-video description length: 1543 characters

Expected behavior

OpenAI-curated plugins should ship SKILL.md metadata that Codex CLI can load without warnings. Long routing details should move from YAML frontmatter description into the markdown body or references.

Actual behavior

Codex skips loading both HeyGen skills, even though the plugin is installed and enabled.

Related context

openai/codex#13941 indicates that rejecting description values longer than 1024 characters is expected behavior. This issue is about the curated plugin content being out of spec, not about changing the loader validation.

View original on GitHub ↗

This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗