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

Resolved 💬 2 comments Opened Jun 8, 2026 by Toshi3886 Closed Jun 8, 2026
💡 Likely answer: A maintainer (github-actions[bot], contributor) responded on this thread — see the highlighted reply below.

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 ↗

2 Comments

github-actions[bot] contributor · 2 months ago

Potential duplicates detected. Please review them and close your issue if it is a duplicate.

  • #25996
  • #26066

Powered by Codex Action

Toshi3886 · 2 months ago

Closing as a duplicate of #26066. HeyGen-specific upstream fix request remains tracked at https://github.com/heygen-com/skills/issues/90.