Codex CLI validates plugin-prefixed skill names against 64-char SKILL name limit, causing valid curated skills to be skipped
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?
- Install Codex CLI 0.135.0.
- Use the curated
build-web-data-visualizationplugin bundle. - Start Codex.
- Observe that several skills are skipped with
invalid name: exceeds maximum length of 64 characters. - Open one affected
SKILL.mdand confirm its raw frontmatternameis below 64 chars. - 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.
This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗