GET YOUR FREE
The Skill Audit Card
Seven checks that tell you whether Claude is reading all of a skill file or only part of it.
One PDF for anyone who has written a skill and cannot tell why it went vague — it names the four limits that gate how much of your file gets loaded, and what to change when one of them fails.
You don’t need to guess which part of your skill is being skipped anymore.
This card is built for one thing: finding the structural failure that has no error message attached to it.
What’s Inside:
– The name field: the character cap, the two reserved words, and the naming form that makes a skill findable.
– The description field: the cap, why third person is not a style preference, and the phrasing that quietly breaks discovery.
– Size and depth: the body-length limit, the one-hop reference rule, and how to split a long file without losing anything.
– The contents list: the hundred-line threshold, the partial read it protects against, and the exact shape of the list to add.
– Freedom and dependencies: matching instruction specificity to how fragile a step is, and writing install commands in instead of assuming.
– Running it automatically: a working skill file that performs all seven checks and hands back a corrected copy for review.
Every check on this card is read from the published skill-authoring documentation, with the limit it tests stated next to it, so you understand the mechanism, not just the shortcut.
Still rewriting a skill from scratch because it stopped behaving?