# Claude Code Skill

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

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** SKILL.md, .claude/skills, /skill-name

## Think of it like

It is like a recipe card in a box. You only pull it out when you cook that dish.

## Definition

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.

## Example code

```markdown
---
name: deploy
description: Ship the site. Use when asked to deploy.
---
1. Run the tests.
2. Run deploy/push.sh.
```

A small skill. The description says when to use it.

## Why it matters

A skill can hold a lot of know-how. It only fills the context when it is used.

## Common mistake

Writing a vague description. Claude picks a skill by its description, so say plainly when to use it.

## Three principles

- **A folder.** With SKILL.md.
- **Loaded when needed.** Name first, body later.
- **Call it by name.** Slash and the name.

## Related terms

- [Agent Skill](https://learn.benibix.com/term/ai/agent-skill)
- [Bundled Skills](https://learn.benibix.com/term/ai/bundled-skills)
- [Claude Code Plugin](https://learn.benibix.com/term/ai/claude-code-plugin)
- [CLAUDE.md](https://learn.benibix.com/term/ai/claude-md)
- [Skill Tool](https://learn.benibix.com/term/ai/skill-tool)
- [Claude Code Skill Frontmatter](https://learn.benibix.com/term/ai/claude-code-skill-frontmatter)

## Told apart from

- [Claude Code Subagent vs Skill](https://learn.benibix.com/compare/claude-code-subagent-vs-claude-code-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 vs Plugin](https://learn.benibix.com/compare/claude-code-skill-vs-claude-code-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.

## Taught in

- [Skills, Plugins and Styles](https://learn.benibix.com/learn/ai-claude-code/skills-plugins-and-styles): Claude Code, 14/16

![A skill folder with a SKILL.md file. Claude reads the short description first and the full steps only when needed.](https://learn.benibix.com/diagrams/cc-claude-code-skill.svg)

---

Source: https://learn.benibix.com/term/ai/claude-code-skill
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-19
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
