Agent Skills vs MCP: What's the Difference and When to Use Each

Emily Winks, Data Governance Expert, Atlan
Data Governance Expert
Updated:07/16/2026
|
Published:07/16/2026
13 min read

Key takeaways

  • Agent Skills are static procedural knowledge; MCP is a live protocol for tool and data access, not a competing standard.
  • Nine independent sources, Anthropic's own comparison included, agree Skills and MCP compose rather than compete.
  • MCP's own docs now recommend using Skills to build MCP servers, a pattern most comparisons miss entirely.
  • A skill that correctly calls MCP for live data still depends on that data being governed, true, and current.

Agent Skills vs MCP

Strip away the runtime, the server, and the auth model, and what is left is a Skill: a static, portable folder of instructions an agent loads when a task matches its description. MCP is a live client-server protocol, built on JSON-RPC, connecting an agent to external tools, data, and prompts through a running process with its own authentication. Neither replaces the other. Nine independent sources on this exact comparison, Anthropic's own included, converge on the same read: Skills answer how, MCP answers access, and most production agents need both.

Key facts include

  • Skill: a static, portable folder of instructions loaded when a task matches its description
  • MCP: a live client-server protocol giving an agent access to tools and data it does not already have
  • Shared pattern: nine independent sources agree the two compose rather than compete
  • Shared gap: neither certifies that the data returned is current or trustworthy

See every layer your agent stack depends on

Get the AI Context Stack

Once your Skill and MCP server are wired up, the real gap is governance maturity: MCP’s Enterprise-Managed Authorization extension went stable June 18, 2026; a static SKILL.md file has no equivalent. Atlan, like DataHub, Alation, Collibra, and Informatica, sits underneath both layers: Atlan’s own MCP server feeds a Skill the governed data it calls MCP to fetch.


Dimension Agent Skills MCP
What it is Static markdown instructions Live client-server protocol
What it does Teaches a procedure or behavior Delivers tool and data access
Who maintains it The agent builder, edited directly The server operator, deployed as a service
Key strength Portable, human-readable, zero infrastructure Live, authenticated, high-frequency data access
Best for Stable knowledge that doesn’t change between runs Data that changes between invocations
Question it answers How should the agent do this? What can the agent reach, and is it allowed to?
Cost model Near-zero until triggered, no server to run Ongoing hosting and auth; some servers use tens of thousands of tokens of context
Complexity Low: a markdown file plus YAML frontmatter Medium to high: JSON-RPC, transports, OAuth

The CIO's Guide to Context Graphs

A primer for leaders deciding where governance sits in an agent stack that already runs Skills, MCP servers, or both.

Get the Guide

Agent skills vs MCP: what’s the difference?

Permalink to “Agent skills vs MCP: what’s the difference?”

Anthropic’s own litmus test draws the line plainly: a Skill explains how to follow a procedure; MCP is what the agent reaches for when it needs a database or file it doesn’t already have. ByteByteGo reduces it to one axis: does the data change between invocations (MCP), or stay stable for weeks (Skills)? Anthropic created MCP in late 2024, donating it to the Agentic AI Foundation under the Linux Foundation in December 2025, then published Agent Skills as an open standard on December 18, 2025, why the two get conflated: same origin, adopted by other vendors since.

The confusion is tired enough that practitioners flag it before arguing anything. A June 2026 Hacker News comment opens with, “Before you get too far into the usual ‘MCP is dead, Skills forever’ debate…” The debate is settled; what’s underserved is naming the two failure modes plainly: a Skill nobody reliably triggers, and an MCP server that blows the context budget, both covered below. This boundary sits inside skill engineering and the context engineering framework that context engineering operates under.


What is an agent skill?

Permalink to “What is an agent skill?”

An Agent Skill is a portable, version-able unit of procedural knowledge: a markdown file with a small YAML frontmatter block that teaches an agent a specific, repeatable task, independent of any live data connection. Simon Willison puts it plainly: “Skills are Markdown with a tiny bit of YAML metadata and some optional scripts.” It loads through progressive disclosure, metadata first, full body only when triggered, and runs wherever the host agent runs, no server required. Not long after Anthropic’s release, OpenAI quietly adopted the same format in ChatGPT and Codex CLI, and one Hacker News thread offers a useful corrective for anyone assuming a Skill is a thinner MCP server: “Skills has nothing to do with tool calling at all.” The Enterprise Skills governance guide covers the file format further; Agent Skills vs Tools draws the adjacent boundary against a single tool call.

Core components of an agent skill

Permalink to “Core components of an agent skill”
  • Frontmatter (name, description): always-loaded metadata the agent scans for relevance
  • SKILL.md body: the full procedural instructions, loaded only once triggered
  • Bundled scripts and resources: optional helper files loaded on demand
  • No built-in runtime or auth model: a Skill relies on whatever tools or MCP connections the host agent already has, a gap AI agent primitives covers more broadly. It maps to what Atlan calls procedural memory, distinct from the facts an agent’s memory stores

What is MCP (Model Context Protocol)?

Permalink to “What is MCP (Model Context Protocol)?”

MCP is a client-server protocol, built on JSON-RPC, giving an agent live, structured access to external tools, data, and prompts through a standardized set of primitives, Resources, Tools, and Prompts, over stdio, HTTP, or other transports. Unlike a Skill, it runs as a persistent process other hosts connect to. Atlan’s own MCP-vs-API guide covers this architecture in depth.

MCP’s governance is materially more mature than Skills’ today. Its Enterprise-Managed Authorization extension (Zero-Touch OAuth) reached stable status on June 18, 2026, with Okta as first identity provider and adoption already from Anthropic, VS Code, Asana, Atlassian, Canva, Figma, Granola, Linear, and Supabase, a capability Skills structurally cannot replicate since they carry no built-in auth model. The protocol is stewarded by the Agentic AI Foundation, which also governs agent interoperability protocols like MCP vs A2A.

Core components of MCP

Permalink to “Core components of MCP”
  • Resources, Tools, and Prompts: the three primitive types a server exposes
  • JSON-RPC transport: stdio, HTTP, and other transports carry protocol traffic
  • OAuth-native authentication: including the Enterprise-Managed Authorization extension above
  • Persistent server process: distinct from plain function calling or a direct API path, covered in why MCP matters for AI agents
  • AAIF governance: co-founded by Anthropic, Block, and OpenAI

Context Gap Calculator

Estimate how much of the data your Skills and MCP servers touch is actually certified and current.

Check Your Gap

Agent skills vs MCP: head-to-head comparison

Permalink to “Agent skills vs MCP: head-to-head comparison”

The sharpest differences show up in runtime model, authentication, and governance maturity. Skills are static and locally executed; MCP is live and centrally served.

Dimension Agent Skills MCP
Protocol / format Markdown plus YAML frontmatter JSON-RPC over stdio or HTTP transports
Runtime model Loaded into context locally, no running process Persistent client-server process
Execution Agent reads and follows instructions Schema-validated, typed tool and resource calls
Discovery Progressive disclosure via description, agent decides relevance Explicit tool and resource listing at connection time
Authentication No built-in auth model OAuth-native, Enterprise-Managed Authorization since June 2026
Governance body Anthropic plus community skill registries Agentic AI Foundation, Linux Foundation
Update mechanism Edit the markdown file directly, no redeploy Versioned server deployment and redeploy
Context cost Lightweight until triggered Can be heavy; GitHub’s official server alone consumes tens of thousands of tokens before any work happens
Failure mode Rarely invoked or unreliable to maintain at scale Works in dev, breaks under production auth and governance load
Maturity signal Published December 2025, already in ChatGPT and Codex CLI Originated late 2024, mature AAIF governance, stable enterprise auth

Jerry Liu, Co-founder and CEO of LlamaIndex, shared the lesson from building LlamaIndex’s own coding agent: “Skills are way easier to setup, but unreliable/hard to maintain.” Their docs MCP handled the job; Skills were rarely invoked, evidence the “right” choice is empirical, tied to the workload. These failure modes connect to why MCP matters for AI agents and to how a governed AI control plane sits above both layers.


How do agent skills and MCP work together?

Permalink to “How do agent skills and MCP work together?”

Skills and MCP solve different problems in the same stack, which is why “use both” is the emerging default, not a compromise. David Cramer, co-founder and Chief Product Officer at Sentry, frames it simply: “If skills teach you to cook, MCP provides the instruments that let you do it.” The common pattern: a Skill encodes the procedure, then reaches through an MCP server for the live data. The point most write-ups miss runs the opposite direction: MCP’s own docs now recommend using Skills to build MCP servers, via a reference mcp-server-dev plugin, Skills as tooling for MCP infrastructure, not just an alternative to it. Cramer’s own stack: two always-on MCP servers alongside roughly a dozen Skills, why cra.mr rejects any “X is all you need” framing here.

The “access alone is enough” assumption is already cracking in production. Reddit’s r/mcp increasingly reports servers that “work in dev but break in production” under real auth and governance load, and Snowflake’s announced intent to acquire Natoma, an enterprise MCP platform, was framed around agents needing “business context and the ability to take action securely,” not just a live connection. Neither resolves the question; both confirm the market is asking it: once a Skill correctly calls MCP for live data, is what comes back actually true?

When to prioritize one: start with a Skill for stable knowledge that doesn’t depend on runtime data: style guides, coding conventions, internal playbooks. Start with MCP when data changes between invocations or needs authentication. Invest in both for a production agent whose procedures reach live, governed systems, the same agent harness layer harness engineering and its comparison against prompt engineering address, and the distinction agent harness vs agent framework draws.

Agent skill and MCP stack diagram showing skills handling orchestration and MCP handling live access to tools and data


How Atlan approaches agent skills and MCP

Permalink to “How Atlan approaches agent skills and MCP”

Every source in this comparison, Anthropic included, treats “MCP delivers the data” as the end of the story, without asking whether what comes back is itself certified, current, or correctly defined.

Atlan doesn’t compete with Agent Skills or MCP. Per Atlan’s Context Activation and Retrieval capability, “One Context Layer. Many Protocols. Many Tools,” Atlan’s context layer treats MCP as one of several delivery protocols, alongside API, SQL, search, vector retrieval, and graph traversal, not a competitor and not the same layer as a Skill. Atlan’s own MCP server delivers governed metadata, lineage, glossary terms, quality scores, and access policies to any MCP-compatible agent or Skill at runtime. As Atlan’s enterprise Skills guide puts it: the Skill instructs how, the context layer guarantees what’s true, on the same context graph foundation behind Atlan’s harness engineering work and implementation path.


Real stories from real customers: context behind skills and MCP

Permalink to “Real stories from real customers: context behind skills and MCP”

"We're excited to build the future of AI governance with Atlan. All of the work that we did to get to a shared language at Workday can be leveraged by AI via Atlan's MCP server…as part of Atlan's AI Labs, we're co-building the semantic layer that AI needs with new constructs, like context products."

— Joe DosSantos, VP of Enterprise Data & Analytics, Workday

"Atlan is much more than a catalog of catalogs. It's more of a context operating system…Atlan enabled us to easily activate metadata for everything from discovery in the marketplace to AI governance to data quality to an MCP server delivering context to AI models."

— Sridher Arumugham, Chief Data & Analytics Officer, DigiKey

Neither quote is about the Skills-vs-MCP boundary specifically; both point at the same shift this comparison sets up.

Check Your Agent's Context Readiness

See whether the data behind your Skills and MCP-connected agents is current and certified before you ship.

Check Readiness

Where the real question sits after “how” and “access” are settled

Permalink to “Where the real question sits after “how” and “access” are settled”

Skills teach an agent how. MCP gives it access. Nine independent sources, Anthropic included, already treat that as settled, and “use both” is the practical result. What none fully answer is the question this page sets up rather than resolves: a Skill reaching through MCP for live data still depends on that data being governed, certified, and correctly defined. Governed Context for Agent Skills takes that question on directly; Atlan’s enterprise Skills guide is the closest existing treatment of the same boundary today.

Worth exploring next:


FAQs about agent skills vs MCP

Permalink to “FAQs about agent skills vs MCP”

1. What is the difference between agent skills and MCP?

Permalink to “1. What is the difference between agent skills and MCP?”

Agent Skills are static markdown instructions teaching an agent a procedure. MCP is a live client-server protocol giving an agent access to tools and data it doesn’t already have. Skills answer “how”; MCP answers “access.”

2. Do agent skills replace MCP?

Permalink to “2. Do agent skills replace MCP?”

No. They solve different problems in the same stack. A Skill has no built-in way to authenticate against a live system; MCP has no built-in way to encode a repeatable procedure.

3. Can you use skills and MCP together?

Permalink to “3. Can you use skills and MCP together?”

Yes, and this is the default pattern now, not an edge case. A Skill commonly encodes the procedure while reaching through an MCP server for the live data it needs. The reverse also happens: Skills now scaffold MCP servers themselves.

4. What is MCP (Model Context Protocol)?

Permalink to “4. What is MCP (Model Context Protocol)?”

MCP is a client-server protocol, built on JSON-RPC, giving an AI agent structured, live access to external tools, data, and prompts through hosts, clients, and servers.

5. What are Claude agent skills?

Permalink to “5. What are Claude agent skills?”

Agent Skills are a portable file format, a markdown file plus a small YAML frontmatter block, teaching an AI agent to perform a specific, repeatable task. Anthropic published the standard on December 18, 2025, and it now runs across dozens of platforms beyond Claude.

6. Does a skill need an MCP server to work?

Permalink to “6. Does a skill need an MCP server to work?”

Not always. A Skill only needs MCP when its procedure depends on live, changing, or authenticated data. LlamaIndex found the opposite for some workloads: Skills went unused while an existing MCP handled the job.

7. How do skills and MCP handle authentication differently?

Permalink to “7. How do skills and MCP handle authentication differently?”

Skills have no built-in authentication model; they inherit whatever access the host agent already has. MCP is OAuth-native, and its Enterprise-Managed Authorization extension, stable since June 2026, adds zero-touch identity support starting with Okta.

8. Does the Atlan context layer work with both agent skills and MCP?

Permalink to “8. Does the Atlan context layer work with both agent skills and MCP?”

Yes. Atlan’s MCP server delivers governed metadata, lineage, glossary terms, quality scores, and access policies to any MCP-compatible agent or Skill at runtime, so the procedure a Skill encodes runs against certified data, not merely reachable data.


Sources

Permalink to “Sources”
  1. Skills explained: How Skills compares to prompts, Projects, MCP, and subagents, Anthropic/Claude. https://claude.com/blog/skills-explained
  2. Skills vs MCP tools for agents: when to use what, LlamaIndex. https://www.llamaindex.ai/blog/skills-vs-mcp-tools-for-agents-when-to-use-what
  3. MCP, Skills, and Agents, cra.mr, David Cramer. https://cra.mr/mcp-skills-and-agents/
  4. EP213: MCP vs Skills, Clearly Explained, ByteByteGo. https://blog.bytebytego.com/p/ep213-mcp-vs-skills-clearly-explained
  5. Build with Agent Skills, official Model Context Protocol docs. https://modelcontextprotocol.io/docs/develop/build-with-agent-skills
  6. Enterprise-Managed Authorization: Zero-touch OAuth for MCP, Model Context Protocol blog. https://blog.modelcontextprotocol.io/posts/enterprise-managed-auth/
  7. Claude Skills are awesome, maybe a bigger deal than MCP, Simon Willison. https://simonw.substack.com/p/claude-skills-are-awesome-maybe-a
  8. “Skills vs MCP” discussion, Hacker News. https://news.ycombinator.com/item?id=46250332
  9. Zero-Touch OAuth for MCP discussion, Hacker News. https://news.ycombinator.com/item?id=48592163
  10. Agent Skills overview, agentskills.io. https://agentskills.io/home
  11. MCP vs Tool Calling vs Skills: When to Use Each Layer, Mervin Praison. https://mer.vin/2026/04/mcp-vs-tool-calling-vs-skills-when-to-use-each-layer-in-llm-agent-architecture/
  12. Model Context Protocol donation announcement, Linux Foundation / Agentic AI Foundation. https://www.linuxfoundation.org/
  13. Snowflake to Acquire Natoma to Bring Governed Agentic Access to the Enterprise, Snowflake. https://www.snowflake.com/en/blog/snowflake-acquire-natoma-governed-agentic-access/

Share this article

signoff-panel-logo

Atlan is the Context Layer for AI, a Leader in the Gartner Magic Quadrant for D&A Governance (2026) and the Forrester Wave for Data Governance (Q3 2025). Atlan unifies your data, business knowledge, and the meaning behind your terms into one Enterprise Data Graph that gives every team and every AI agent the trusted context they need. Trusted by Mastercard, Workday, General Motors, CME Group, HubSpot, FOX, Virgin Media O2, Elastic, and 400+ enterprises representing $10T+ in market cap.

Bridge the context gap.
Ship AI that works.

[Website env: production]