SKILL.md plus optional references/). This is the markdown-only skill format — useful when a skill is documentation-driven rather than backed by a @Skill class.
For class-based skills with @Skill decorators, use the Skill Generator instead.
Usage
Options
Generated Files
Generated SKILL.md
When to Use This vs @Skill
- Use
skill-dirfor purely documentation-driven skills (markdown-only) that don’t need executable behavior or DI access. - Use
skillwhen you need a TypeScript class with access to providers, hooks, or other SDK runtime features.