Learn

Skills vs MCP vs Subagents vs Prompts vs Hooks — the mental model.

You installed a skill, and now you're wondering: how is this different from an MCP server? A subagent? Just a good prompt? Short answer — they solve different problems and compose together.

One-line version: A prompt is what you say once. A skill is reusable know-how the model loads when relevant. An MCP server gives the model new actions and live data. A subagent is a separate worker with its own context. A hook is automation that fires on an event. A skill needs no API, no server, no code — it's just a structured instruction file.

The 60-second comparison

What it isGives the model…Needs code/server?Best for
PromptText you sendInstructions for this turnNoOne-off asks; global persona
Skill (SKILL.md)A structured file the model loads on demandReusable expertise — how a pro produces a specific artifactNoRepeatable structured deliverables (PRDs, postmortems, rubrics)
MCP serverA running service (Model Context Protocol)New tools & live data (DB, email, GitHub)YesActing on real systems & data
SubagentA separate agent with its own contextParallelism + isolationNoBig or separable sub-tasks
HookA script that runs on an eventAutomation — before/after a tool, on prompt submitA scriptGuardrails, auto-formatting, auto-loading context

How to choose

They stack: a hook can auto-load a skill, which structures work that an MCP server grounds in live data, optionally delegated to a subagent.

Why skills are so cheap: progressive disclosure

A skill loads in two stages, which is why you can have hundreds installed without blowing up the context:

  1. Always in context (tiny): just each skill's name + description — ~100 tokens each. This is how the model decides what's relevant (and why the description is the most important line in a SKILL.md).
  2. Loaded on demand: the full body — a few thousand tokens — enters context only when that skill is picked.

So 207 skills cost almost nothing until one is actually used. Broad capability, narrow cost.

See it in practice

▶ Run a skill free 🧩 Chain skills into a workflow ⚡ Ground in 500+ apps (Composio) ✍️ Write your own skill

Full written version with links: docs/concepts.md.