update-skill

To create a SKILL.md file, generate the required frontmatter fields, specifically name and description, and apply a consistent modular structure that follows best-practice formatting guidelines for skill authoring.

Updating existing SKILL.md frontmatter involves validating the mandatory name and description fields and refining the body content to align with standard templates, ensuring the skill remains clear and discoverable.

Skill authoring requires mandatory frontmatter fields in SKILL.md to ensure valid name and description entries, which enforces consistent formatting and makes the skills discoverable across a repository.

You can use reusable templates to add optional references and assets to SKILL.md, promoting a modular structure that guides authors on when to split content for better organization.

SKILL.md files often lack consistent formatting and discoverability because of missing mandatory frontmatter or an unmodular structure, which standardized templates and best-practice validation resolve.

You should split content while authoring skill documentation when modular structure and optional assets become unwieldy, using the provided template to guide content separation for clear, maintainable skills.