Claude
Skills

What skills are and how I use them

The framing

An onboarding
guide for Claude.

Teach Claude your way once, like a new hire, and it just knows it after. That's a skill.

Claude
SKILL
One playbook, handed over once.
So how is it different from a prompt?

Prompt vs skill

vs
Promptone-off
Persistence
  • Lives in one chat
  • Starts from zero every time
  • You re-explain yourself
Reliability
  • Instructions the model follows
  • Output varies each time
Skillreusable
Persistence
  • Carries forward
  • Teach it once
  • There in every chat after
Reliability
  • Can bundle real code
  • Runs the exact same way
  • Precise part never drifts
The takeawayA skill is persistent and partly deterministic. More than a fancy prompt.
Fundamentals · The building block

What's inside a skill

A skill is just a folder Claude can open. It bundles everything needed to do one kind of job well: the know-how, the tools, and any reference material, in one place.

One folder · one job
i

The instructions SKILL.md

A written guide telling Claude how to do the task the right way: the rules, the steps, the dos and don'ts.

Always
<>

The tools scripts

Small ready-made programs the skill can run to get work done, like a calculator built for the job.

As needed
R

Reference material resources

Extra files the skill leans on: templates, examples, or rulebooks it checks its work against.

As needed
The key principle · Progressive disclosure

How Claude loads a skill

It doesn't read everything at once. Each layer loads only when the task needs it, which is why a skill can hold huge reference files without slowing anything down.

Always

Skill names & descriptions

One line per skill in your library, always in memory, very small.

On match

The full SKILL.md

Trigger, rules, output format, dos and don'ts. Loads when your prompt matches. Typically a few KB.

On demand

Reference files & scripts

Recipes, column dictionaries, code. Can be large, only loads when the task actually needs it.

Fundamentals · A worked example

How Claude works with a spreadsheet

A spreadsheet arrives as a sealed box of data. Claude can't read it by eye, so the skill opens it, does the math, checks the work, and hands back a clean result.

Step 01

You upload a file

The spreadsheet lands on a temporary computer as a sealed box of packed bytes, not readable text.

Step 02

Claude picks the skill

Seeing a spreadsheet, Claude opens the matching instructions and pulls in the right tools.

Step 03

A hidden engine runs

A small script starts a spreadsheet engine behind the scenes to work out every calculation.

Step 04

Every cell is checked

It scans the whole file for errors and reports exactly where any are, so they get fixed.

Step 05

You get a clean result

A short report confirms zero errors, and the finished spreadsheet is handed back.

Skill
0 errors
Example
Example 01

The skill that
writes like you

Without context, you're just editing forever.

Claude
ClaudeI hope this message finds you well! I wanted to share some exciting updates from our Q1 analysis. The team has worked incredibly hard and the results truly reflect their dedication...
Example 01 · Inside the skill

My writing rules

01

No AI tells

Em dashes, and the other giveaways.

02

No empty openers or closings

"I hope this finds you well."

03

Direct, a little punchy

The tone I actually write in.

Example
Example 02

The skill that
reads your data

Plain English in. Your definitions applied. Structured answer out.

Dataset skill
ClaudeReady. Drop in your dataset and ask your question.
Reading the uploaded dataset...
Applying your metric definitions...
Excluding rows per your rules...
Computing the three metrics...
New ACV
$0M
This quarter
Retention
0%
Gross
Net retention
0%
Incl. upsell
Example
Example 03

The skill that
makes these decks

The very skill behind this presentation. Pick a look, it lays out the slides and renders them.

Slide deck skill
ClaudeTell me the topic and the vibe, I'll build the deck.
Generating style options...
Laying out slides on a 16:9 stage...
Rendering with motion...
Deck rendered · ready to present
Wrapping up

Three skills, one idea

01
Writes like me
02
Reads my data
03
Built this deck
Teach Claude once. It carries forward.
01 / 14