Skip to content
BENIBIX Learn

Claude Code Skill

AI⌨️ Claude CodeClaude Code Concepts

Also known as SKILL.md, .claude/skills, /skill-name

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

Think of it like

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

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.

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 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.
The short description loads first. The steps load only when needed.

Common mistake

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

Key takeaways

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

Compare

Learn it properly