Skip to content
Call wiki

What are Claude Skills, and when do they beat a folder of markdown prompts?

Last updated 2026-08-17 · Confidence: documented — Anthropic’s help center and Claude Code docs; the repetition threshold is inferred and the early bugginess reported.

A skill is a reusable instruction folder Claude pulls in on its own when a task matches its description; it beats a folder of loose markdown prompts once a procedure repeats often enough that you keep pasting the same instructions — while loose files stay right for context that should load every time.

A folder Claude loads when its description matches

Section titled “A folder Claude loads when its description matches”

Anthropic defines skills as “folders of instructions, scripts, and resources that Claude loads dynamically”: only each skill’s short description is preloaded, and the body loads when Claude judges the request relevant — or, in Claude Code, when you type /skill-name. So “prompts that activate on a trigger” is accurate, with one caveat: the trigger is Claude matching your request, not an external event — for those see Event triggers.

When a skill beats a loose prompt file

Section titled “When a skill beats a loose prompt file”

The Claude Code docs draw the line: create a skill when “you keep pasting the same instructions, checklist, or multi-step procedure into chat,” because unlike always-loaded instruction files “a skill’s body loads only when it’s used, so long reference material costs almost nothing until you need it.” Facts, voice, and project context that should apply everywhere still belong in instruction files — see Standing context. The formats converge anyway: in Claude Code a plain markdown prompt file is a skill, and the format is an open standard portable across apps.

Every Claude surface loads skills — Cowork included

Section titled “Every Claude surface loads skills — Cowork included”

Skills run in Claude chat, Cowork, the Microsoft 365 add-ins, Claude Code (beta), and the API with code execution enabled; they’re managed under Customize → Skills.

Record a skill: ten minutes of screen and voice, Mac Cowork only

Section titled “Record a skill: ten minutes of screen and voice, Mac Cowork only”

The recording flow (Pro/Max/Team, Cowork on Mac only) captures your screen, clicks, keystrokes, and narration for up to ~10 minutes, keeps only processed screenshots, and proposes a new skill or an update to an existing one — never show passwords while recording. Its first weeks were rough. The docs give no repetition number for when authoring pays off; a task run on the order of a hundred times a month clearly clears their keep-pasting bar, one you’d do twice doesn’t.

Sources

Section titled “Sources”