New to AI? Start here → Start 1. What can you do with Claude?

Last checked: November 10, 2026

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"

Save what worked as a skill!

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

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).

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 2: it turns what you talked through into a skill file

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

Where people get stuck

Lots of people get stuck here. Find the one that matches your situation!

“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.

Next tip

Do several jobs at once with Claude Code →

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.