Hi friends
This is a follow-up to my post about structuring CLAUDE.md, skills and agents. A comment on that post pointed at a failure layer I had completely skipped, and it deserves its own write-up: your skill bodies can be perfect and the agent still never reads them.
The invisible bottleneck
Skills load lazily, that's the whole point. Until one triggers, the only thing the model can see is the one-line description in the frontmatter. Which means routing accuracy is bounded by how well a single sentence discriminates between neighboring skills.
You can audit every body, verify every code example against the codebase, run retrieval tests on the content... and none of it matters if the model picks the wrong skill, or no skill, or decides the sentence already told it everything it needs.
