Claude Code's SKILL.md format explained: how to write skills that trigger correctly
Claude Code skills are reusable, structured instruction sets designed to replace repetitive procedures users paste into chat sessions. Unlike entries in CLAUDE.md, a skill's body only loads into context when the skill is actually invoked, keeping overhead minimal. Each skill lives in a dedicated directory with a SKILL.md file containing frontmatter fields — most importantly a description, which Claude reads in every session to decide when to activate the skill. The description acts as the trigger mechanism, so it should mirror the natural phrases a user might say, while the body holds the full step-by-step procedure. Optional frontmatter settings like disable-model-invocation and allowed-tools give developers control over whether a skill fires automatically or only on explicit user command.
This is an AI-generated summary. ShortSingh links to the original source for the complete article.
Discussion (0)
Log in to join the discussion and vote.
Log in