Skill Authoring
Overview
Use this skill to keep the skills repository consistent and easy to extend.
Repository Rules
Follow the layout and naming rules in repo-structure.md.
Add Or Update A Skill
- Create or rename the skill folder under
skills/<skill-name>/. - Keep the skill name lowercase and hyphen-separated.
- Write a concise
SKILL.mdwith a precise trigger description. - Add
agents/openai.yamlmetadata that matches the skill. - Create
scripts/,references/, orassets/only when the skill needs them. - Move long explanations out of
SKILL.mdand intoreferences/. - Validate the skill folder before publishing or copying it into your Codex skills path.
Validate
Use the Codex skill-creator validator on each skill folder after editing.
Resources
references/repo-structure.md: canonical layout and authoring rules