Check reference / Correctness & Structure

STRUCT-05 Supporting-file references resolve

Correctness & Structure · 20% of the grade · deterministic · applies to skills

Deterministic — runs on every scan, no LLM or network needed.

Why it matters

SKILL.md is telling Claude to open files that are not in the skill directory — the model burns turns failing to read them, then improvises without the reference material you meant it to have. This is the “references a converter that does not exist” class of bug, and it breaks progressive disclosure entirely.

How to fix it

Ship the missing file, correct the path so it matches a file that is actually in the skill directory, or delete the dead reference. Only local relative paths are checked — external URLs, `#anchors`, absolute paths, and `../` escapes are out of scope.

Example

✗ flagged
See [the converter](scripts/convert.py)  <- scripts/convert.py is not in the skill