A conceptual guide explaining the distinction between instructions and skills in AI agents. Instructions are natural language directives (system prompts) that govern an agent's persona, tone, constraints, and reasoning — always active. Skills are reusable, structured capabilities like API calls and tools — invoked on demand.
Table of contents
IntroductionWhat Are Instructions?What Are Skills?Instructions vs. Skills: Side by SideSkills and MCP Tools: Are They the Same?How Agents Leverage Both — The Core PatternReal-World ExamplesThe Layered Mental ModelWhen to Update Instructions vs. SkillsSummarySort: