All terms
Agents & tools
Skill (Claude Skills)
Also known as: skill, SKILL.md, Claude skill
Installable markdown files that give Claude reusable, named capabilities — like "write a PR description" or "format a sales email" — without retraining or fine-tuning.
What it means
A Claude Skill is a folder containing a SKILL.md file (and optional supporting files) that defines a named capability Claude can invoke. The SKILL.md has YAML frontmatter with metadata — name, description, when to use it — and a markdown body with instructions, examples, and links to helpers. Drop it in ~/.claude/skills/ and Claude can use it.
Skills are essentially structured, installable prompts. When a user's request matches a skill's description, Claude loads the skill body into context and follows its instructions. Think of them as the "apps" of the Claude ecosystem — discrete, shareable units of capability that don't require API keys, fine-tuning, or running a server.
The format was introduced as part of Claude's broader push toward customizability without complexity. Compared to MCP servers (which expose tools and require running code), skills are pure markdown — easier to author, share, and version-control. Compared to custom GPTs (OpenAI's equivalent on the assistant side), skills are file-based and work in Claude Code, Claude Desktop, and the API equally.
In practice teams use skills for: codifying internal style guides ("write a PR description like our team does"), wrapping common workflows ("triage a bug report"), and embedding domain knowledge ("explain this FERC regulation"). They're a low-friction way to make an LLM consistently good at something specific.
Example
You create ~/.claude/skills/pr-description-writer/SKILL.md with your team's PR template and tone rules. Anyone on the team running Claude Code with that skill installed gets consistent, on-brand PR descriptions automatically.
Why it matters
Skills are how Claude scales beyond one-off prompts without becoming a fine-tuning project. They make organizational AI knowledge portable, version-controllable, and reusable. If you're tired of pasting the same instructions into every chat, you should be writing a skill.