Codex SKILL.md Authoring for Directory Names and Triggers
Write concise repository skill documentation with matching names and specific trigger descriptions.
中文Install in Codex
Open a project with repository-level skill directories in Codex. Bring the folder name, real trigger and expected behavior.
- Review `.agents/skills/writing-skills/SKILL.md` and its requirements at the pinned GitHub commit.
- Create `.agents/skills/writing-skills/` in your project and save the reviewed file as `.agents/skills/writing-skills/SKILL.md`.
- Start Codex from that project's root, then type `$writing-skills` and select the matching skill.
Example task
Check the name and description for this illustrative skill.
{"folder":"csv-column-check","draftName":"csv-check","trigger":"validating CSV headers","behavior":"reports missing columns"}What to check
Use `csv-column-check` for the name. An English description is `Use when validating CSV headers - reports missing columns`.
Original SKILL.md on GitHub · Updated
Frequently asked question
Should I place all project context in the skill body?
Keep the constraints and instructions relevant to the task. Reference supporting files from the body if needed.