All posts
AI Engineering·7 min read·Updated 18 Sept 2026

Agent Skills vs MCP (2026): What Each Does and When to Use Which

Quick answer
Agent Skills teach an AI agent how to do something: a SKILL.md with instructions and scripts, loaded only when relevant. MCP connects the agent to systems it cannot otherwise reach, such as Jira, a database or a browser. Use a skill for know-how, an MCP server for access, and both together for most real workflows.

Agent Skills and MCP both extend AI agents, but differently: skills teach an agent how to do something, MCP connects it to systems it cannot reach. Differences, token cost, and when to combine them.

Piyush Jangir
Verified author

Founder of StackPicks. Self-taught builder shipping open-source dev tools, marketing, and curator content since 2019. Based in Mumbai, India. Available on GitHub and LinkedIn.

7 min read
Agent Skills vs MCP (2026): What Each Does and When to Use Which

Short version: a skill is know-how, an MCP server is reach. Skills tell the agent how to do a job with the access it already has. MCP gives it access to something it could not touch before. Most real workflows use both, and both are open standards that work across Claude Code, Codex, Gemini CLI and more.

Agent Skills vs MCP side by side

What a skill is

A skill is a folder with a SKILL.md file: YAML frontmatter with a name and description, then instructions, plus optional scripts and reference files. In Claude Code, personal skills live in ~/.claude/skills/ and project skills in .claude/skills/. The agent reads the description and loads the full skill only when a task needs it.

Agent Skills was published as an open standard at agentskills.io in December 2025, and Codex, Gemini CLI, GitHub Copilot, Cursor and VS Code read the same format.

What MCP is

The Model Context Protocol connects an agent to external systems through servers that expose tools and data. A server might be a local process, such as Chrome DevTools, or a remote service with OAuth, such as Atlassian's. Anthropic released MCP in November 2024; the 2026-07-28 specification is current.

The token difference

Skills are cheap when idle: only their descriptions sit in context until one is needed. MCP servers are not: every connected server's tool definitions load into every request. That asymmetry is why a dozen skills cost less than a dozen servers, and why pruning idle servers is a quick way to reduce Claude Code token usage.

When to use a skill, an MCP server, or both

When to use which

  1. The agent has access but lacks the procedure: write a skill.

- Review checklists, deploy steps, house writing style.

  1. The agent cannot reach the system: install or build an MCP server.

- Jira, a database, a browser, an internal API.

  1. Both: a skill that uses an MCP server's tools.

- Google's stitch-skills pairs with the Stitch MCP server this way.

  1. Unsure: start with a skill; it takes minutes to write.

Browse both: the Agent Skills directory and the MCP directory.

Frequently asked questions

Is an Agent Skill the same as an MCP server?+

No. A skill is a folder containing a SKILL.md file of instructions, plus optional scripts and reference files, that the agent reads when a task calls for it. An MCP server is a separate program or remote service that exposes tools and data over the Model Context Protocol, often with its own authentication. Skills add know-how; MCP adds reach.

Which uses fewer tokens, skills or MCP?+

Skills are cheaper when idle. Claude Code loads only each skill's description until a task needs it, and truncates that listing text, so an unused skill costs very little. Each connected MCP server adds its tool definitions to every request whether or not you use them. That is why pruning idle MCP servers is one of the quickest ways to reduce token usage.

Can a skill use an MCP server?+

Yes, and that combination is common. A skill can describe how to do a job using tools an MCP server provides, for example a release-notes skill that uses GitHub's MCP server to read merged pull requests. Google's stitch-skills library is built this way, designed to work with the Stitch MCP server for UI generation.

Are Agent Skills and MCP both open standards?+

Yes. MCP was released by Anthropic in November 2024 and is now used across the industry, with the 2026-07-28 specification as the current version. Agent Skills was published as an open standard at agentskills.io in December 2025 and is read by Claude Code, Codex, Gemini CLI, GitHub Copilot, Cursor, VS Code and others. Both are portable across agents.

Should I write a skill or build an MCP server?+

Write a skill if the agent already has the access it needs and lacks the procedure: your team's review checklist, deploy steps or writing style. Build or install an MCP server if the agent needs to reach a system it cannot touch today, such as an internal API, a SaaS product or a database. Skills are far quicker to write, so start there when either would work.

More in AI Engineering

Agent Skills vs MCP (2026): What Each Does and When to Use Which — StackPicks — StackPicks