writing-science-skills

The required frontmatter structure for science skills mandates specific name and description fields to enforce clear documentation and ensure future agents can accurately parse skill metadata.

To outline a new skill document, define the name and description in frontmatter, then fill the markdown body with required sections and a single-sentence Quick Start instruction for immediate usability.

Defining dependencies and components is optional during skill authoring, but adding them ensures consistency across skills and helps verify skill structure before deployment in documentation.

The best way to verify skill structure before deployment is assessing complexity, category, keywords, and dependencies against the standard frontmatter template and required three-section body structure.

Your science skill documentation needs a Quick Start section to provide a single-sentence instruction that enables immediate usability and satisfies the structural requirements for effective skill references.

You can edit existing skills without rebuilding the frontmatter if the required name and description fields remain intact, allowing you to update the markdown body sections while maintaining structural compliance.