SkillsBasicClaude Code
In a skill, the description is the loading criterion
Claude loads a skill by comparing your request with its description: if it is vague, it does not load in any runtime.
The same SKILL.md runs in Claude Code, the Messages API and the Agent SDK, and in all three it is activated by the description. Write it as a condition: what it does and when it applies. Instructions that must hold in every session go in CLAUDE.md; skills are for procedures that load on demand.
Example
Vague: description: "Helps with deploys." Precise: description: "Validates a deploy's configuration before a release. Use it when the user asks to review or validate deploy config."