skill-builder

To create agent skills, use a standardized SKILL.md template with YAML frontmatter defining metadata, triggers, and dependencies. Keep the body concise by moving detailed content to references, ensuring structured three-tier progressive disclosure loading.

Progressive disclosure in skill development keeps the SKILL.md body concise by moving detailed content to optional references directories. Use this mechanism when writing new skills or auditing quality to ensure efficient context loading across various domains.

Structure YAML frontmatter in your SKILL.md by defining the skill name, description, dependencies, context, and access controls. These metadata fields establish the triggers that activate the agent skills and manage the loading environment for prompt design.

Yes, you can use the skill-builder to evaluate and refine existing agent skills. It provides a structured, repeatable process for auditing quality, iterating on prompt design, and validating frontmatter metadata and reference docs across various domains.

Organize optional references, scripts, and checklists by creating a new skill directory containing the SKILL.md file alongside these components. This structure supports progressive disclosure, keeping the core prompt design separate from detailed reference docs.

No dependencies are required to start writing a new skill with YAML frontmatter. You can create a new skill directory with a minimal SKILL.md and optional references to get started, defining dependencies within the frontmatter as needed for access controls.