Skill Design

What you’re actually writing when you write a SKILL.md

Skills for AI agents are loader specifications, not merely long prompts, operating on a principle of progressive disclosure with three distinct loading levels to manage context window cost. Understanding this architecture is crucial, as content placement directly impacts efficiency and prevents common antipatterns like monolithic skills or mismanaged metadata. Proper skill design optimizes context usage, improves portability, and ensures consistent performance, especially when dealing with envir