Claude Clue #15: Skills Are Just Files Your Model Can Find
A skill is essentially a file that your model can access on demand to tailor its behavior for a specific task.
Last time I introduced skills and hooks as concepts for Claude Code. Now let's dig into skills properly. A skill is essentially a file that your model can access on demand to tailor its behavior for specific tasks—think of it as giving Claude focused expertise instead of relying on its general knowledge. Each skill has three parts: YAML frontmatter (just a name and description so the model can actually find it), instructions (the heart of what you want it to do), and resources (reference material or code snippets). The frontmatter matters more than you'd think—I've learned to ask Claude for suggestions on naming because models will straight-up ignore files with confusing descriptions.
Shorter, more focused skills tend to work better in my experience. Models can handle long context just fine, but they're more likely to miss things in the middle than at the start or end—kind of like humans, honestly. So I've had better luck with tight skill files that point to separate detailed reference files rather than cramming everything together. The really good news? Skills persist once created, and the format has been adopted across frontier models—so what you build for Claude should work with other models too. Check out the official Claude Code documentation for the full spec.
This clue was crafted with Claude as my AI assistant.