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.
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.
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.
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.