Skills
Keep Skill file references exactly one level deep from SKILL.md — nested links cause partial reads
When a reference file links to yet another file, Claude tends to preview with head -100 rather than read the whole thing, so deeply nested references (SKILL.md → advanced.md → details.md) silently deliver incomplete information. Link every reference file directly from SKILL.md so each is read in full when triggered, and add a table-of-contents to any reference over 100 lines so partial previews still reveal full scope. Keep the SKILL.md body under 500 lines and push detail to these one-hop files.
Source
↳ Follow the thread