Handbooks  /  Agent Skills vs MCP
AI~9 min readComparison
Head to Head

Agent Skills vs MCP: knowledge in context, or capability over a wire?

These two get compared as if they were rivals, but they answer different questions. A Skill changes what the agent knows and how it approaches a task — it is packaged instruction, loaded into context. MCP changes what the agent can reach — it is a protocol that hands the agent live tools and data at runtime. One is memory; the other is hands. The interesting design work is deciding which of your problems is which.

01

The one distinction that decides everything

An Agent Skill is a package of knowledge and procedure — typically a SKILL.md plus supporting files — that gets loaded into the model’s context to shape how it behaves: when to do something, the steps, the conventions, the examples. It is declarative and static: it ships as files and teaches. MCP (the Model Context Protocol) is a client-server protocol that exposes tools, resources and prompts from an external server to the agent at runtime. It is imperative and live: it does not teach the agent anything, it grants it the ability to call real systems.

→ The rule

Does your problem need the agent to know or decide something? That is a Skill. Does it need the agent to reach or do something in a live system? That is MCP. Knowledge in context vs capability over a wire.

02

Head to head

DimensionAgent SkillsMCP
What it addsKnowledge, procedure, conventionsLive tools, data, actions
ShapeFiles (Markdown + assets)A running client-server protocol
When it actsLoaded into context, ahead of the taskCalled at runtime, during the task
Needs a running service?No — just files the host readsYes — an MCP server must be up and wired
Cost modelContext tokens while loadedTool-schema tokens + network round-trips
PortabilityAny host that reads skill filesAny MCP-capable host, but each needs the server configured
Failure modeMisfires, bloats context, teaches the wrong thingServer down, latency, auth, injection over the wire
Security surfaceInjected-instruction riskNetwork + supply-chain + tool-abuse risk
03

When to reach for each

Agent Skills

  • Encoding a house style, workflow, or checklist
  • Teaching when and how to use tools the agent already has
  • Domain knowledge the agent should apply consistently
  • Anything that is instruction, not action
  • Sharing a repeatable procedure as portable files

MCP

  • Reading or writing a live system (DB, tickets, files)
  • Calling an external API the agent could not otherwise reach
  • Fetching fresh data at request time
  • Actions with real side effects
  • Reusing one integration across many agents and hosts
04

Portability is not the same kind of portability

Both claim portability, but they mean different things. A Skill is just files, so it travels anywhere a host is willing to read skill files — copy the folder and it works, with nothing to run. MCP’s portability is protocol portability: a growing ecosystem of dozens of MCP-capable hosts (on the order of forty and climbing) can talk to any compliant server, so one server you write is reusable across all of them. The catch is that "reusable" still means each host has to be pointed at the server, given credentials, and trusted.

So the two portabilities trade against each other. Skills have zero operational surface — but they cannot do anything on their own. MCP servers do real work and are write-once, reuse-everywhere at the protocol level — but every deployment carries a running service, its uptime, and its auth. Skills spread like documents; MCP spreads like infrastructure.

→ The distinction

Skill portability = copy a file. MCP portability = one server, many hosts — but each host still has to run and trust it. Files vs infrastructure.

05

They compose — a Skill can drive an MCP tool

The framing as rivals falls apart the moment you build something real, because the best pattern uses both. A Skill supplies the judgment — when this situation arises, here is the procedure — and inside that procedure it tells the agent to call a specific MCP tool to actually touch the world. The Skill is the playbook; the MCP tool is the move. Neither replaces the other: a tool with no guidance gets misused, and guidance with no tool cannot act.

The costs stack the same way. A Skill spends context tokens for as long as it is loaded, so an overlong Skill crowds out the task; an MCP tool spends schema tokens to advertise itself plus a network round-trip each call, and adds a real attack surface — a compromised or hostile server, or content it returns, can try to steer the agent. Designing well means keeping Skills tight and scoped, and treating every MCP server as untrusted input at the boundary.

→ The pattern

Skill decides when and how; MCP tool does it. Keep Skills lean to save context; gate MCP servers like any external dependency.

06

A worked scenario: an on-call triage agent

You want an agent that triages incidents. The Skill encodes the runbook: how to classify severity, which signals to check first, the escalation ladder, the tone for a status update. That is pure knowledge — it belongs in context, ships as files, and applies the same way everywhere the agent runs. None of it requires a running service.

But triage means touching live systems: query the metrics store, read recent deploys, open or update a ticket, post to the incident channel. Each of those is an MCP tool — a live capability the agent calls at runtime through a server you wired up once and reuse across every agent and host. The Skill tells it which tool to reach for and when; MCP is how it actually reaches. Rip out the Skill and the agent flails with powerful tools; rip out MCP and the agent knows exactly what to do and cannot do any of it.

→ The takeaway

Runbook → Skill. Live queries and actions → MCP. The comparison resolves not to a winner but to a division of labor: memory and hands.

Frequently asked

Quick answers

What is the difference between Agent Skills and MCP?

An Agent Skill is packaged knowledge and procedure — usually a SKILL.md plus files — loaded into the model’s context to change how it behaves. MCP (the Model Context Protocol) is a client-server protocol that gives the agent live tools, data and actions from an external server at runtime. A Skill changes what the agent knows; MCP changes what it can reach. One is memory, the other is hands.

Do Agent Skills and MCP compete?

No — they compose. The strongest pattern uses a Skill to supply judgment (when a situation arises, here is the procedure) and has that procedure call a specific MCP tool to actually act on a live system. A tool with no guidance gets misused; guidance with no tool cannot act. They cover different halves of the problem.

Which is more portable?

They are portable in different ways. A Skill is just files, so it travels anywhere a host reads skill files, with nothing to run. MCP offers protocol portability — one server works across dozens of MCP-capable hosts — but each host still has to run, configure and trust the server. Skills spread like documents; MCP spreads like infrastructure.

What are the security differences?

A Skill’s main risk is injected-instruction: it steers the agent, so a bad or hijacked Skill teaches bad behavior, and an overlong one crowds out the task. An MCP server adds a network and supply-chain surface: it is a running service with credentials, and both the server and the content it returns can attempt to steer the agent. Keep Skills scoped, and treat every MCP server as untrusted at the boundary.

Agent Skills vs MCP · Vibe Engines · 2026
Finished this one? 0 / 160 Handbooks done

Explore the topic

See this alongside everything else on the same subject — handbooks, system designs, challenges and tools, in one place.