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.

Related terms

See it in a comparison

Related skills