Building skills
in Claude.
I started with
prompts.
The books became
a team.
A folder became
a skill.
A skill is a folder
with a SKILL.md.
---
name: reply-in-my-voice
description: Drafts replies in my voice.
  Use when I write, answer or draft mail.
---
Keep it short. Start with the answer.
Never use exclamation marks.
Name
Lowercase, hyphens, same as the folder.
Description
The only part Claude reads at first. It decides when the skill is used.
Instructions
Read only when the skill matches.
A dossier.
A colleague.
A skill is know-how.
An agent puts it to work.
Skill
Agent
What it is
Knowledge and instructions, packed in a file
Something that acts, with access to tools
Behavior
Passive. Loaded when needed
Active. Decides, carries out, iterates
Think of
A file the AI pulls from the cabinet
A colleague who gets to work with it
Use it for
Know-how you want to reuse
A job that has to run on its own
Example
Chris Voss, read my mail before I send it
An agent that takes my standup recording, fills in the app and drafts your recap mail
The description
does the work.

Helps with emails.

Too vague. Claude cannot tell when to use it, and it clashes with other mail skills.

Drafts replies in my voice. Use when I ask to write, answer or draft a mail.

What it does, when to use it, and the words you actually say.
The skill that
makes skills.
github.com/anthropics/skills
skills/skill-creator, made by Anthropic
A supermarket
of skills.
skills.sh
npx skills add owner/repo
Can you
trust a skill?
📈 Installs
Over 10,000 is a good sign.
🏢 Source
Anthropic or a maker you know is safer than a stranger.
👀 Read it
Open the SKILL.md and the scripts folder yourself.
Read the skill
before you install it.
🐙 GitHub
Open the repo. Find SKILL.md and the scripts folder.
📝 MarkEdit
Free Markdown editor for Mac. Open the SKILL.md and read it.
✨ Typora
Paid, very clean. Same job, on Mac and Windows.
Your turn: a skill from
someone you learn from.
YouTube, a blog, a book
collect their content, then ask the skill creator
Build your
skill.
📥 Collect
5:00click or press T
Pick a person. Gather transcripts or posts.
🔨 Build
15:00click or press T
Ask the skill creator. Answer its questions.
🧪 Test
10:00click or press T
New chat. Ask a real question. Then let the skill creator eval it.
🎤 Show
10:00click or press T
Show one answer that your skill gave.
I walk around. Ask me anything.
Keep your finger
on the button.
disable-model-invocation: true
only you can run it. Use it for deploys and commits.
Send long jobs
down the road.
context: fork
the work happens in its own subagent, your chat stays clean
Every line
costs something.
under 500 lines
keep SKILL.md short, move detail into separate files
Check your skills
now and then.
/skill-doctor
finds skills that cost room and are never used
One chef,
many stations.
orchestrator
one skill that runs the others, in order
Make it
worth sharing.
unknown.sitelane.nl
all tips and tricks, on the page for this lesson