R007 · body-size
Body within size budget
- Code: R007
- Slug:
body-size - Tier: structure
- Default severity: warning
- Packages: recommended, strict
- Locked: No
- Doc: https://doraval.dev/reference/rules/R007
| What | Warns when the SKILL.md body exceeds roughly 20 000 characters (~5k tokens at ~4 chars/token). |
| Why | Skills load in layers: frontmatter always, body on trigger, references/ / scripts/ / assets/ on demand. A long body steals context from the task. |
How to fix
- Keep the procedural core in
SKILL.md. - Move deep tables and long examples into
references/(one topic per file). - For a huge reference file, add a short table of contents at the top.
- Prefer a script under
scripts/for fragile, order-critical work — see R023.