Claude Code Skill vs Plugin
People think a plugin is just a bigger skill. It is not. A skill is one folder of steps that Claude loads when a task needs it. A plugin is a package that can carry many skills, plus helpers, hooks and MCP servers, so a team can install the lot in one step. Write a skill first. Pack it in a plugin when others should get it too.
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 Plugin
A package that adds skills, hooks, helpers and servers in one go.
A plugin is a package that adds several things to Claude Code at once. It can hold skills, hooks, subagents and MCP servers. You install it with the /plugin command, usually from a marketplace. A plugin's skills get the plugin's name in front, such as plugin-name:skill-name. That way two plugins can both have a skill called review without a clash.
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 Plugin
- A package that adds skills, hooks, helpers and servers in one go.