codex - 💡(How to fix) Fix Codex CLI validates plugin-prefixed skill names against 64-char SKILL name limit, causing valid curated skills to be skipped

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
RAW_BUFFERClick to expand / collapse

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:

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.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

codex - 💡(How to fix) Fix Codex CLI validates plugin-prefixed skill names against 64-char SKILL name limit, causing valid curated skills to be skipped