As skills grow in complexity, they may contain too much context to fit into a single SKILL.md , or context that’s relevant only in specific scenarios. In these cases, skills can bundle additional files within the skill directory and reference them by name from SKILL.md . These additional linked files are the third level (and beyond) of detail,... See more

At startup, the agent pre-loads the name and description of every installed skill into its system prompt.

This metadata is the first level of progressive disclosure : it provides just enough information for Claude to know when each skill should be used without loading all of it into context. The actual body of this file is the second level of... See more