codex - 💡(How to fix) Fix Plugin skill name validation rejects skills with qualified name > 64 chars

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…

The build-web-data-visualization curated plugin has 8 skills that are silently skipped during loading because their qualified names (plugin_name:skill_name) exceed the 64-character maximum.

Root Cause

The plugin name build-web-data-visualization is 30 characters. When qualified with : and the skill name, the combined names push past the 64-char threshold:

Qualified nameLength
build-web-data-visualization:grammar-of-graphics-and-declarative-visualization78
build-web-data-visualization:scrollytelling-and-parallax-data-visualization75
build-web-data-visualization:uml-and-software-architecture-visualization72
build-web-data-visualization:typescript-data-visualization-engineering70
build-web-data-visualization:statistical-and-uncertainty-visualization70
build-web-data-visualization:geospatial-and-cartographic-visualization70
build-web-data-visualization:accessibility-and-inclusive-visualization70
build-web-data-visualization:dashboards-and-real-time-visualization67

The 10 other skills in the same plugin have qualified names ≤ 64 and load fine.

Code Example

/Users/.../skills/accessibility-and-inclusive-visualization/SKILL.md: invalid name: exceeds maximum length of 64 characters
/Users/.../skills/dashboards-and-real-time-visualization/SKILL.md: invalid name: exceeds maximum length of 64 characters
/Users/.../skills/geospatial-and-cartographic-visualization/SKILL.md: invalid name: exceeds maximum length of 64 characters
/Users/.../skills/grammar-of-graphics-and-declarative-visualization/SKILL.md: invalid name: exceeds maximum length of 64 characters
/Users/.../skills/scrollytelling-and-parallax-data-visualization/SKILL.md: invalid name: exceeds maximum length of 64 characters
/Users/.../skills/statistical-and-uncertainty-visualization/SKILL.md: invalid name: exceeds maximum length of 64 characters
/Users/.../skills/typescript-data-visualization-engineering/SKILL.md: invalid name: exceeds maximum length of 64 characters
/Users/.../skills/uml-and-software-architecture-visualization/SKILL.md: invalid name: exceeds maximum length of 64 characters
Skipped loading 8 skill(s) due to invalid SKILL.md files.
RAW_BUFFERClick to expand / collapse

Description

The build-web-data-visualization curated plugin has 8 skills that are silently skipped during loading because their qualified names (plugin_name:skill_name) exceed the 64-character maximum.

Repro

On a system with the build-web-data-visualization plugin installed (version 94a36683), Codex emits:

⚠ /Users/.../skills/accessibility-and-inclusive-visualization/SKILL.md: invalid name: exceeds maximum length of 64 characters
⚠ /Users/.../skills/dashboards-and-real-time-visualization/SKILL.md: invalid name: exceeds maximum length of 64 characters
⚠ /Users/.../skills/geospatial-and-cartographic-visualization/SKILL.md: invalid name: exceeds maximum length of 64 characters
⚠ /Users/.../skills/grammar-of-graphics-and-declarative-visualization/SKILL.md: invalid name: exceeds maximum length of 64 characters
⚠ /Users/.../skills/scrollytelling-and-parallax-data-visualization/SKILL.md: invalid name: exceeds maximum length of 64 characters
⚠ /Users/.../skills/statistical-and-uncertainty-visualization/SKILL.md: invalid name: exceeds maximum length of 64 characters
⚠ /Users/.../skills/typescript-data-visualization-engineering/SKILL.md: invalid name: exceeds maximum length of 64 characters
⚠ /Users/.../skills/uml-and-software-architecture-visualization/SKILL.md: invalid name: exceeds maximum length of 64 characters
⚠ Skipped loading 8 skill(s) due to invalid SKILL.md files.

Root cause

The plugin name build-web-data-visualization is 30 characters. When qualified with : and the skill name, the combined names push past the 64-char threshold:

Qualified nameLength
build-web-data-visualization:grammar-of-graphics-and-declarative-visualization78
build-web-data-visualization:scrollytelling-and-parallax-data-visualization75
build-web-data-visualization:uml-and-software-architecture-visualization72
build-web-data-visualization:typescript-data-visualization-engineering70
build-web-data-visualization:statistical-and-uncertainty-visualization70
build-web-data-visualization:geospatial-and-cartographic-visualization70
build-web-data-visualization:accessibility-and-inclusive-visualization70
build-web-data-visualization:dashboards-and-real-time-visualization67

The 10 other skills in the same plugin have qualified names ≤ 64 and load fine.

Impact

Users lose access to 8 visualization skills (accessibility, dashboards, geospatial, grammar-of-graphics, scrollytelling, statistical, typescript-engineering, UML) with no actionable guidance — the warning references the SKILL.md path but not which field or what the computed name is.

Possible approaches

  1. Raise the limit to at least 96 characters to accommodate compound plugin+skill names.
  2. Only validate the skill-local name (from the SKILL.md name field) and let the qualified form be an internal composite.
  3. Truncate or hash long qualified names internally instead of rejecting them.
  4. Improve the warning to show the computed qualified name and the current limit so users can act on it.

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