New to AI? Start here → Start 1. What can you do with Claude?
Make your own skill
In one line
A skill is a folder with one instruction sheet called SKILL.md. Tell Claude Code “turn what we just did into a skill,” and next time one sentence gets it done the same way.
The big picture
★ CLAUDE.md vs. a skill ★
📌 CLAUDE.md
Rules it always follows
"Don't delete files"
🧩 Skill
A guide it pulls out for a specific job
"Organize receipts in this order"
Follow along
Step 1. Do it well once first
A skill saves a method that worked. First, do the job all the way through once with Claude Code. For example: turning a folder of receipt photos into an Excel budget.
Step 2. Ask it to make a skill
Illustration (may look a little different from the real screen)
Turn the receipt organizing method we just used into my personal skill. Name it receipt-ledger. Write a clear description of when to use it, and include the rules we changed along the way (the date format and the "needs checking" mark).
Sample replyI created ~/.claude/skills/receipt-ledger/SKILL.md.
Description: use when turning a folder of receipt photos into an Excel budget
Steps: 1) read the photos 2) dates as YYYY-MM-DD 3) blurry text marked [needs checking] 4) a totals sheet
Step 3. Look inside the skill file
SKILL.md is a plain text file that looks like this:
---
name: receipt-ledger
description: Use when turning a folder of receipt photos into an Excel budget
---
1. Read all the photos in the folder.
2. Write dates in YYYY-MM-DD format.
3. Mark blurry text as [needs checking].
4. Make a totals sheet at the front.
The description at the top matters most. Normally Claude Code only looks at this description, and when a matching job comes along, it pulls out and reads the rest.
Step 4. Use it and refine it
Next month, in your receipts folder, just say “Organize my receipts.” If the result falls short, fix it with something like “Add ‘cover card numbers’ to the receipt-ledger skill.”
More ways to use it
- A “polish my blog post” skill: your tone, heading rules, how many hashtags
- A “month-end wrap-up” skill: which files in which folder get combined, in what order
- You can make skills in Claude chat too → Make your own skill (emails in your voice)
Where people get stuck
“It doesn’t use the skill”
If the description is vague, it won’t know when to use it. Spell out the situation, like “Use when…” You can also call it by name: “Do it with the receipt-ledger skill.”
“What’s the difference between a personal skill and a folder skill?”
Put it in .claude/skills in your user folder and it works everywhere; put it in .claude/skills inside a working folder and it only works in that folder.
“Can I share it with others?”
Just send the whole skill folder. Check first that there’s no personal information or passwords in it.
I'm stuck here
Stuck while following along? Tell me where. Only the site owner sees this. Leave your email only if you'd like a reply.
💌 Get new tips by email
I'll email you when a new tip goes up. No ads, ever.