Skill Creation Guide

Generate properly formatted SKILL.md files that help AI agents perform domain-specific tasks effectively.

File Structure

Every skill must have:

• YAML frontmatter with required fields
• Markdown body with clear instructions
• Progressive disclosure (concise main file, detailed references separate)

Optional directories:

• scripts/: Executable code agents can run. Keep scripts self-contained or document dependencies, and include clear error handling.
• references/: On-demand documentation (for example, REFERENCE.md, templates, domain notes). Keep files focused and small for efficient context usage.
• assets/: Static resources such as templates, diagrams, and data files.

Recommended layout: