Skip to content
BENIBIX Learn

Claude Code Subagent vs Skill

People think a skill and a subagent are two names for one helper. They are not. A skill is a set of steps that Claude reads into the chat you are in. A subagent is a second worker with its own fresh context and its own tools, and it sends back only a summary. Use a skill to teach Claude a job. Use a subagent to keep a big search out of your chat.

AI⌨️ Claude Code

Claude Code Skill

A folder with a SKILL.md file of steps. Claude Code loads it when a task needs it.

A Claude Code skill is a folder with a SKILL.md file of instructions, saved in .claude/skills/ or in your home folder. Claude Code follows the open Agent Skills format. At the start, Claude only sees each skill's name and short description. It reads the full file when the task needs it, or when you type a slash and the skill's name. Claude Code adds its own options on top, such as running a skill in a subagent.

Example
Lucy writes a skill with her team's release steps. Now she types /release and Claude follows the same steps every time.
Why it matters
A skill can hold a lot of know-how. It only fills the context when it is used.
Full entry
AI⌨️ Claude Code

Claude Code Subagent

A helper agent you define in a Markdown file. Claude hands it tasks to do.

A Claude Code subagent is a helper you define in a Markdown file. The file sits in .claude/agents for one project, or in ~/.claude/agents for all of them. A short header gives it a name, says when to use it, and lists its tools and model. The text below the header is its own system prompt. Claude hands it a task, and it works in a fresh context and sends back a summary.

Example
Emma makes a code-improver subagent. She gives it only Read, Grep and Glob. Claude now sends it code to review, and it can look but never edit.
Why it matters
Each subagent works in its own clean context. Big searches stay out of your main chat, and each helper gets only the tools it needs.
Full entry

In one line

Claude Code Skill
A folder with a SKILL.md file of steps. Claude Code loads it when a task needs it.
Claude Code Subagent
A helper agent you define in a Markdown file. Claude hands it tasks to do.