Dev.to
7/22/2026

The original title is: "SKILL.md: how to write a Claude Code skill that actually triggers (format + template)"
Original: SKILL.md: how to write a Claude Code skill that actually triggers (format + template)
Short summary
A detailed guide to writing Claude Code skills using the SKILL.md format, covering frontmatter fields, triggering mechanics, arguments, and supporting files. The key insight is that the description serves as the trigger for model invocation while the body loads only on use. Includes a copy-paste template and explains the critical distinction between knowledge skills (model-invoked) and action skills (slash-only).
- •SKILL.md format: description is the trigger, body is the procedure
- •Frontmatter fields: name, description, disable-model-invocation, allowed-tools
- •Knowledge skills are model-invoked; action skills are slash-only for safety
Generated with AI, which can make mistakes.
Is this a good recommendation for you?



