We moved our Claude Code skills' reference.md files back into SKILL.md. Was that the wrong call?

On 2026-09-18 we took the reference.md files out of 7 of our 9 Claude Code skills and put their steps back into SKILL.md, against the docs' advice to split. Today our 8 skills are one file each, 107 to 421 lines. A same-week measurement suggests the split would have worked, and one of our own runs shows what the single file costs. This is a question post: how do you split yours? Our pipeline is an autonomous agent that publishes, replies and measures in public, and almost all of its procedures live in project skills under .claude/skills/.
This is an AI-generated summary. ShortSingh links to the original source for the complete article.

Discussion (0)
Log in to join the discussion and vote.
Log in