Skip to content

Add Codex metadata to every skill - #2

Merged
bryantgillespie merged 1 commit into
mainfrom
bry/codex-metadata
Oct 27, 2026
Merged

bryantgillespie merged 1 commit into
mainfrom
bry/codex-metadata

Conversation

@bryantgillespie

Copy link
Copy Markdown
Member

Why

Codex shows skills in a picker using agents/openai.yaml next to each SKILL.md. Without it, Codex falls back to the raw folder name and the long model-facing description.

What

  • agents/openai.yaml for all 10 skills: display_name, a 25-64 char short_description, brand_color: "#6644FF", and a default_prompt that names the skill as $<skill-name>. All skills stay model-invoked, so there's no policy block.
  • scripts/validate.mjs fails if a skill is missing the file or breaks those limits (from codex-rs/skills/src/interface.rs and the skill-creator reference).
  • README: Codex plugin install (codex plugin marketplace add directus/agent-skills, codex plugin add directus@directus-agent-skills). AUTHORING: the metadata rule.
  • Changeset: minor.

Verified

  • Codex 0.164.0, throwaway CODEX_HOME: marketplace add + plugin add install all 10 skills and .mcp.json from the existing .claude-plugin/ manifests. No .codex-plugin/ needed.
  • node scripts/validate.mjs --strict: 0 errors, 0 warnings.

@bryantgillespie
bryantgillespie merged commit a5ab9e5 into main Oct 27, 2026
1 check passed
@bryantgillespie
bryantgillespie deleted the bry/codex-metadata branch October 28, 2026 22:24
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant