Create New Skills

To create an Agent Skill, set up a Skill directory and add a SKILL.md file with required frontmatter metadata like name and description, then include optional scripts, references, or assets to support the workflow.

Progressive disclosure in Agent Skills is a content organization pattern where Codex loads structured SKILL.md frontmatter and supporting files like scripts, references, and assets on demand to efficiently manage context.

Required frontmatter for an Agent Skill includes the name and description fields, which enable proper discovery and consistent metadata loading by Codex.

The best way to structure a Skill directory for reuse is to codify domain knowledge into a SKILL.md with proper frontmatter, and organize supporting scripts, references, and assets using guided workflow templates.

Yes, you can include optional resources when building a Skill by adding supporting files such as scripts, references, and assets alongside the mandatory SKILL.md file to enhance the workflow.

Frontmatter enforcement in SKILL.md is needed to mandate name and description fields, ensuring consistent metadata structure that enables reliable discovery and on-demand loading by Codex.