managing-agent-skills

Create a SKILL.md file with YAML frontmatter containing required fields: name and description. Add optional allowed-tools to restrict tool access, define progressive disclosure sections, and structure workflow and references for discoverability and security compliance.

YAML frontmatter requires name and description fields. Follow path conventions, include optional allowed-tools specifications, organize workflow and references sections, and adhere to token-count guidance. Frontmatter governance ensures skills are reusable and discoverable.

Apply a structured validation framework checking YAML frontmatter completeness, allowed-tools restrictions, progressive disclosure patterns, and reference documentation. Validation ensures skills meet technical requirements and security standards for the agent environment.

Analyze existing skills using the provided framework to identify gaps in frontmatter, workflow clarity, and progressive disclosure. Propose modernizations to YAML structure, tool restrictions, and documentation to enhance reusability and agent performance.

Progressive disclosure manages how skill complexity is revealed through structured references and sections. Integrate it into skill authoring workflows via frontmatter governance to balance accessibility with advanced functionality and support secure, guided skill usage.

Basic YAML familiarity helps, but the skill provides structured requirements and conventions for frontmatter. Follow the defined templates for name, description, and allowed-tools fields; the workflow and validation sections guide proper organization without deep YAML expertise.