skill-creator

To create a Codex skill, use the Skill Initializer to scaffold a new directory and generate a SKILL.md template with valid frontmatter. You then customize the template body and add optional resources like scripts or assets before packaging.

The SKILL.md template includes structured frontmatter with name, description, and metadata fields, alongside a customizable body. It supports progressive disclosure to keep the main file lean while offering deeper references as needed.

You package Codex skills into .skill files by running validation and packaging scripts after finalizing your SKILL.md and resource scaffolding. This ensures frontmatter validity and bundles the directory into a distributable format.

Organizing resource directories is optional but recommended when building a Codex skill. The framework suggests standard scaffolding for scripts, references, and assets folders with sample placeholders to jumpstart development.

You can update existing Codex skills by editing the SKILL.md frontmatter and body, adjusting resource scaffolding, and re-running validation and packaging scripts to ensure the updated module remains valid for distribution.

Validating and packaging Codex skills requires the pyyaml dependency to parse and ensure frontmatter validity. The scripts component handles the initialization, validation, and packaging workflows automatically.