R011 · supporting-dirs
Supporting dirs and referenced files stay in-skill
- Code: R011
- Slug:
supporting-dirs - Tier: structure
- Default severity: FYI
- Packages: recommended, strict
- Locked: No
- Doc: https://doraval.dev/reference/rules/R011
| What | Notes which supporting directories exist (references/, scripts/, assets/, examples/). Warns when a Skill link is missing or leaves the skill root. |
| Why | Supporting dirs are progressive-disclosure layers. A broken or outside-root link ships a bundle the agent cannot load. |
How to fix
A dir-exists FYI needs no action. Use references/ for long material and scripts/ for fragile procedures when the body grows (R007).
A missing-link or outside-root warning: add the file, fix the path, or keep the target under the skill root.