fix: move top-level version into metadata for Codex skill validation - #806
fix: move top-level version into metadata for Codex skill validation#806huangzigen666 wants to merge 1 commit into
Conversation
Codex's SKILL.md frontmatter validation rejects a bare top-level `version:` field. Move it under `metadata:` across all 17 Codex skills, matching the structure Codex expects. Reapplies the local fix from 7e26c45b1 on top of upstream v1.2.4.
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 8d62e35ba1
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| metadata: | ||
| version: 0.2.1 |
There was a problem hiding this comment.
When this fix is published, all plugin and marketplace manifests still advertise version 1.2.4, so consumers or registries that treat a published version as immutable can retain the invalid pre-fix skill files instead of receiving these corrected copies. Update the relevant plugin.json and marketplace.json versions with this change.
AGENTS.md reference: AGENTS.md:L110-L115
Useful? React with 👍 / 👎.
1 participant
Codex CLI's
SKILL.mdfrontmatter validation rejects a bare top-levelversion:field, so the 17 skills undercodex/skills/fail validation on load.This moves
version:undermetadata:, matching the structure Codex expects. Frontmatter restructure only — no content changes, and everymetadata.versionvalue is identical to the original top-level one.Claude Code is unaffected either way:
versionis in its accepted frontmatter field set, so the marketplace build needs no change.Verification
All 17 skills load in Codex CLI 0.146.0 — confirmed via
codex debug prompt-input, which renders the model-visible skill list without making an API call. All 17 appear with theirnlpm:namespace and correct file paths.Body content is untouched: the code samples inside
writing-skills/SKILL.mdthat demonstrate frontmatter still showversion:at the top level, since those are illustrative, not parsed.🤖 Generated with Claude Code