document-skills

To write a SKILL.md file, use a kebab-case folder name, include required frontmatter fields like name and description, and structure sections for Inputs, Output, Process, and Reference to ensure progressive disclosure.

The required frontmatter fields for creating a skill are name and description. These fields ensure the host structure properly identifies and aligns the skill content.

Structure skill documentation for progressive disclosure by organizing content so the assistant loads frontmatter, the SKILL.md body, and references or assets on demand, keeping required sections separate from optional resources.

The best way to update an existing SKILL.md layout is to align folder naming and frontmatter with host structure, then reorganize sections into Inputs, Output, Process, and Reference while adding optional scripts and assets as needed.

You need to align folder naming with host structure when creating or updating a skill, ensuring the folder uses kebab-case formatting so the host can properly load and reference the skill components.

Yes, you can add optional scripts, references, and assets to a SKILL.md. These resources support the core skill content and are loaded on demand through progressive disclosure.