Claude Code Skills: Reusable Instruction Packs That Make AI Work Your Way

Have you ever had to explain the same request to Claude over and over, day after day? Skills are what let you "teach" Claude once and have it stick for good.

What Is a Skill?

Claude Code Skills are compact instruction packs that live in a .claude/skills/ folder (for a project) or ~/.claude/skills/ (for personal use). Every skill must contain a SKILL.md file.

The interesting part is that you don't need to type any command at all. At the start of every session, Claude automatically reads the name and description of every skill (about 100 tokens each). When your task matches one of them, Claude loads that whole skill on its own. This is called progressive disclosure, and it saves context while still loading the right thing at the right time.

The Structure of a Skill

my-skill/
├── SKILL.md          # required
├── scripts/          # supporting Python/Bash
├── references/       # reference docs
└── assets/           # templates, sample examples

The top of SKILL.md is YAML frontmatter, which declares the name, description, and the tools it's allowed to use:

---
name: code-reviewer
description: >
  Review code for bugs, security issues, and style.
  Use when user shares code and asks to review, audit, or check quality.
allowed-tools: Read, Glob, Bash
---

After the frontmatter comes the markdown instructions for Claude, as short or as long as you want.

Two Main Types of Skills

Capability uplift skills give Claude an ability it doesn't have by default: web scraping, generating PDFs, browser automation. These usually come with executable Python or Bash scripts.

Encoded preference skills capture your organization's or your own personal standards: commit message format, brand guidelines, a code review checklist. These need nothing more than a SKILL.md, no extra code required.

Quick Install

# Personal use, applies across every project
cp -r my-skill/ ~/.claude/skills/

# Project use, shared with the team via git
cp -r my-skill/ .claude/skills/

# Install from the marketplace
/plugin install code-reviewer@anthropic-agent-skills

Once installed, there's nothing else to do. Claude knows on its own when to use it.

The Secret to Getting a Skill to Trigger at the Right Time

The description field in the frontmatter matters more than you'd think. Claude uses that exact text to decide whether to load a skill. The more specific the description, the more precisely the skill fires.

For example, instead of writing "Review code," write "Review code for bugs, security issues, and style. Use when user shares code and asks to review, audit, or check quality." The difference is huge.

The Most Popular Skills in 2026

Here are a few of the skills the community uses the most right now, published directly in Anthropic's official repo: https://github.com/anthropics/skills/tree/main/skills

• frontend-design (277K installs) helps Claude understand a design system before writing UI code
• code-reviewer reviews PRs systematically, without missing bugs
• brand-guidelines encodes a brand's colors, typography, and tone of voice
• skill-creator is a meta-skill that helps you build new skills faster

If you focus on software development, there's also the Superpowers skill: https://github.com/obra/Superpowers

Superpowers is a complete software development methodology for your coding agents, built on a set of composable skills plus upfront instructions that make sure your agent actually uses them.

🆚 How Are Skills Different From Everything Else?

A lot of people mix up Skills, Slash Commands, MCP Servers, and CLAUDE.md. Here's the quick way to tell them apart:

Slash commands require you to type /command-name manually. Skills trigger automatically based on context.

MCP servers provide tools and data, the raw ingredients. Skills are the recipes that tell Claude how to use those ingredients.

CLAUDE.md is shared context for the whole project. Skills are reusable capabilities you install once and use everywhere.

Is there something you keep "teaching" Claude over and over that doesn't have a skill yet? Share it below.