Tips // Claude in practice

Tips for working better with Claude

One short tip at a time, with an example you can copy. Move through them at random or search for what you need.

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."
#skills#description#portability