Skip to content
AnthropicAnthropic

Claude Agent Skills Explained

Agent Skills are organized folders that package expertise that Claude can automatically invoke when relevant to the task at hand. Join the Claude Developer Discord - https://anthropic.com/discord Learn more about Agent Skills - https://www.claude.com/blog/skills 00:06 Introducing Agent Skills 00:30 How Agent Skills work 01:08 Agent Skills vs Claude.md 01:42 Agent Skills vs MCP Servers 02:05 Agent Skills vs Subagents 02:33 Putting it all together 02:48 Summary

Nov 25, 20253mWatch on YouTube ↗

At a glance

WHAT IT’S REALLY ABOUT

Portable Agent Skills bring reusable expertise to Claude workflows everywhere

  1. Agent Skills are portable, folder-packaged expertise that Claude can automatically invoke when a task matches their description across Claude Code, the API, and claude.ai.
  2. Skills use progressive disclosure: only skill names/descriptions load at startup, then full skill.md and referenced files/scripts load only when needed to save context tokens.
  3. Claude.md documents are project-specific guidance (stack, conventions, repo structure), while skills capture reusable domain workflows that apply across many projects.
  4. MCP servers provide standardized access to external data/tools (e.g., GitHub, Linear, Postgres), while skills teach Claude how to use that access effectively according to your team’s practices.
  5. Subagents are role-based assistants with their own prompts, contexts, and permissions; skills are shared expertise that any subagent (or agent) can load and apply.

IDEAS WORTH REMEMBERING

5 ideas

Agent Skills package reusable expertise that auto-activates when relevant.

A skill is described in a way Claude can match against user prompts, so the right workflow guidance appears without the user explicitly pasting playbooks each time.

Progressive disclosure keeps contexts small even with many skills installed.

Only the name/description is present initially (~30–50 tokens per skill), and the full skill.md plus any referenced assets load only when a task triggers them.

Use Claude.md for project facts; use skills for cross-project practices.

Claude.md anchors Claude in a specific repo’s tech stack and conventions, while a skill can encode standards like UI patterns or security review steps that travel between repos.

MCP connects Claude to systems; skills define what “good use” looks like.

An MCP server can expose databases or issue trackers, but a skill can enforce your team’s query optimization patterns or reporting conventions when interacting with that data.

Subagents separate roles and permissions; skills unify shared standards.

Different subagents (e.g., frontend builder vs UI reviewer) can share the same accessibility or design-system skill, ensuring consistent standards across specialized roles.

WORDS WORTH SAVING

5 quotes

Agents today are pretty intelligent, but they don't always have the domain expertise you need for real work, and skills help solve this.

— Otto

You can think of skills as organized folders that package expertise that Claude can automatically invoke when relevant to the task at hand.

— Otto

This progressive disclosure allows you to install many different skills to perform complex tasks without bloating your context window.

— Otto

MCP connects to data, skills teach Claude what to do with it.

— Otto

At the end of the day, skills let you package workflows into reusable capabilities, like helping onboard new hires to your team's coding standards, ensuring every PR follows a specific security best practices, or sharing your data analysis methodology across your team.

— Otto

Definition of Agent Skills as organized expertise foldersProgressive loading and token/context efficiencyPortability across Claude Code, API, and claude.aiComparison: Skills vs Claude.md (project config)Comparison: Skills vs MCP servers (data access)Comparison: Skills vs subagents (role specialization)Workflow examples: onboarding, PR security checks, shared analysis methods

High quality AI-generated summary created from speaker-labeled transcript.

Get more out of YouTube videos.

High quality summaries for YouTube videos. Accurate transcripts to search & find moments. Powered by ChatGPT & Claude AI.

Add to Chrome