R001 · frontmatter-presence
Frontmatter block present
- Code: R001
- Slug:
frontmatter-presence - Tier: structure
- Default severity: error
- Packages: minimal, recommended, strict
- Locked: No
- Doc: https://doraval.dev/reference/rules/R001
| What | Checks that the skill starts with a YAML frontmatter block delimited by --- lines. |
| Why | Frontmatter identifies the skill and describes when an agent should load it. Without that metadata, discovery is unreliable. |
How to fix
Add a YAML frontmatter block at the start of SKILL.md. Include at least name and description:
---
name: my-skill
description: Use when …
---
## Instructions
…