Codex CLI validates plugin-prefixed skill names against 64-char SKILL name limit, causing valid curated skills to be skipped

Open 💬 1 comment Opened May 29, 2026 by montblanc13

What version of Codex CLI is running?

codex-cli 0.135.0

What subscription do you have?

ChatGPT Plus or API Key

Which model were you using?

GPT-5 via Codex CLI

What platform is your computer?

Linux x64

What terminal emulator and version are you using (if applicable)?

bash on Linux

Codex doctor report

What issue are you seeing?

n startup, Codex CLI skips 8 curated OpenAI skills from the build-web-data-visualization plugin with errors like:

```text
Skipped loading 8 skill(s) due to invalid SKILL.md files.

.../skills/uml-and-software-architecture-visualization/SKILL.md: invalid name: exceeds maximum length of 64 characters
.../skills/typescript-data-visualization-engineering/SKILL.md: invalid name: exceeds maximum length of 64 characters
.../skills/geospatial-and-cartographic-visualization/SKILL.md: invalid name: exceeds maximum length of 64 characters
.../skills/dashboards-and-real-time-visualization/SKILL.md: invalid name: exceeds maximum length of 64 characters
.../skills/grammar-of-graphics-and-declarative-visualization/SKILL.md: invalid name: exceeds maximum length of 64 characters
.../skills/accessibility-and-inclusive-visualization/SKILL.md: invalid name: exceeds maximum length of 64 characters
.../skills/statistical-and-uncertainty-visualization/SKILL.md: invalid name: exceeds maximum length of 64 characters
.../skills/scrollytelling-and-parallax-data-visualization/SKILL.md: invalid name: exceeds maximum length of 64 characters

### Root-cause analysis

I investigated locally and found that the raw name: field inside the affected SKILL.md files is not over 64 characters.

Example:

  • uml-and-software-architecture-visualization = 43 chars

The failure matches exactly if Codex validates the plugin-prefixed skill name instead:

  • build-web-data-visualization:uml-and-software-architecture-visualization = 72 chars
  • build-web-data-visualization:grammar-of-graphics-and-declarative-visualization = 78 chars

This also matches the boundary behavior:

  • build-web-data-visualization:data-visualization = 47 chars -> loads
  • build-web-data-visualization:react-and-nextjs-data-visualization = 64 chars -> loads
  • build-web-data-visualization:visualization-strategy-and-critique = 64 chars -> loads
  • names above 64 chars are skipped

So the bug appears to be that Codex CLI applies the 64-char skill name validation to the qualified form plugin_name:skill_name, instead of validating only the name: frontmatter field.

What steps can reproduce the bug?

  1. Install Codex CLI 0.135.0.
  2. Use the curated build-web-data-visualization plugin bundle.
  3. Start Codex.
  4. Observe that several skills are skipped with invalid name: exceeds maximum length of 64 characters.
  5. Open one affected SKILL.md and confirm its raw frontmatter name is below 64 chars.
  6. Prefix that same name with build-web-data-visualization: and observe the resulting qualified name exceeds 64 chars.

What is the expected behavior?

Curated skills whose raw SKILL.md frontmatter name is valid should load successfully, even if the display name or qualified plugin-prefixed name exceeds 64 characters.

Additional information

I also found these strings embedded in the local Codex binary:

  • Skipped loading ... skill(s) due to invalid SKILL.md files
  • Skills from this plugin are prefixed with ...

That strongly suggests the plugin prefixing is part of the internal skill loading path.

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗