writing-skills

To create and verify skills for Codex CLI, follow a TDD-like workflow using a dedicated authoring guide. This process enforces discovery optimization principles and specific frontmatter definitions to ensure your custom skills are reliable and easy to find.

The best way to structure Codex skills for discoverability is to apply naming and describing principles that optimize discovery. Adhering to specific frontmatter definitions and authoring best practices ensures your reusable workflows are easily found.

Writing Codex CLI skills requires a specific development workflow based on a TDD-like process. This structured approach guides you through writing, editing, and verifying skills to guarantee they meet essential quality criteria before deployment.

To test and verify a custom skill before deploying it to Codex, use a quality checklist provided by the authoring guide. This ensures the skill meets essential criteria, adheres to frontmatter definitions, and functions reliably.

When authoring skills for Codex CLI, you can include components like references to address specific needs. These components support the creation of reusable workflows, decision guides, and tool references within the ecosystem.