Skill Structure

Directory Structure

skill-name/
├── SKILL.md              # Main definition (required)
├── references/           # Detailed reference documentation
│   ├── api.md
│   └── patterns.md
├── rules/                # Contextual rules
│   └── coding-style.md
└── examples/             # Practical examples (optional)
    └── basic-usage.md

Main File (SKILL.md)

The SKILL.md file is the skill’s entry point and must contain:

Required Sections

Section	Description
Role Definition	Description of the skill’s role and expertise
When to Use	Activation conditions and keywords
Critical Rules	Rules that MUST and MUST NOT be followed
Technologies	Technology stack covered

Recommended Sections

Section	Description
Core Workflow	Main workflow
Decision Frameworks	Decision trees for technical choices
Reference Documentation	Links to detailed references
Quick Reference	Snippets and quick-use patterns

Naming Conventions

• Use kebab-case for skill names and files
• Prefix rules with context: astro-components.rule.md
• Use .md extension for all documentation files

Metadata

Skills can include metadata in frontmatter:

---
name: astro-framework
version: 1.0.0
keywords: [astro, islands, static, SSR]
---