What's Actually in a Claude Skill? A One-Sentence Answer

The video opens the smallest skill example, a folder called mining holding one sentence about where diamonds spawn in Minecraft 1.20. It shows that a skill is a file Claude reads and follows, giving consistent answers that stop where the file stops.

1:25 video3 min readWatch on YouTube

It is easy to guess that a Claude skill means built-in knowledge, as if Claude simply knows the topic. The video says otherwise: a skill is a folder Claude checks before it acts, and what is inside the folder sets the limits of the answer. To show this, it opens one of the smallest skills in the wild, called "mining."

The naive guess

The video begins with the assumption that Claude just knows Minecraft trivia, and that a skill is a kind of built-in knowledge. The answer given is that it is not. Claude reads a file. The question then becomes what actually happens when Claude reads a skill.

One folder, one file

The skill is a folder named mining, and opening it reveals exactly one file, SKILL.md. A natural second guess is that Claude was already trained on years of Minecraft guides, and that the skill only gives it permission to say what it already knows. The video treats this as the wrong guess and moves straight to the contents of the file.

The whole file is one sentence

Opening SKILL.md shows no permission statement, no reasoning and no guide to cross-reference. The entire file is one sentence: where diamonds spawn in Minecraft 1.20. Claude reads that sentence and then acts on it directly. The video points out that there is no branching and no extra steps are invented along the way. The mechanism is simply to read the instruction, follow it and hand back the answer.

Same answer twice, and nothing more

When the same question is asked twice, the answer comes back identical both times, and the video calls that consistency real. But the file only ever said one thing. If you ask about Minecraft 1.21 instead, or about emeralds instead of diamonds, there is nothing left for the skill to reach for. This is the limit of the approach as the video presents it: the skill's answer comes from the one sentence in its file, not from general recall.

What a skill is

The video's conclusion is that a Claude skill is not Claude knowing more. It is Claude reading one short file right before it answers, and it cannot answer past what that file says. The mining example is used because it makes the point vividly. It is not a claim that every skill is this small.

Key takeaways

  • A Claude skill is a folder that Claude checks before it acts, not built-in knowledge.
  • The mining skill contains a single file, SKILL.md.
  • That file holds one sentence about where diamonds spawn in Minecraft 1.20.
  • Claude reads the instruction, follows it and returns the answer without inventing extra steps.
  • Asking the same question twice produces the identical answer.
  • Asking about another version or another resource finds nothing in the file to use.
  • A skill's answers cannot go beyond what its file says.

Try it yourself

The video suggests handing Claude a short instruction file of your own, such as a note, a checklist or a short document, rather than the Minecraft example. Ask it to say exactly what it will read in the file and what it will do with it before it acts. Watching it explain first is how you see the constraint for yourself.

Chapters

  1. 0:00The naive framing: "Claude just knows"
  2. 0:09The folder, one file: mining/SKILL.md
  3. 0:18The wrong guess: already trained on it?
  4. 0:26The anchor: SKILL.md is one sentence
  5. 0:37The mechanism: read, follow, answer
  6. 0:46The anchor returns: same answer, nothing more
  7. 0:59Carry-out
  8. 1:08Your turn
  9. 1:21Outro
Full transcript(auto-generated, with timestamps)

The naive framing: "Claude just knows"

[0:00]You guess Claude just knows Minecraft trivia that a skill means built-in knowledge. It doesn't. It reads a file. So, what's actually happening when Claude reads a skill? A Claude skill is

The folder, one file: mining/SKILL.md

[0:10]A folder Claude checks before it acts. This one is called mining. Open it up and there's exactly one file inside skill.md. The natural guess is that Claude already

The wrong guess: already trained on it?

[0:19]Knows this, trained on years of Minecraft guide somewhere in there, and the skill just gives it permission to say so.

The anchor: SKILL.md is one sentence

[0:26]Open skill.md and there's no permission, no reasoning, no guide to cross-reference one sentence. Where diamonds spawn in Minecraft 1.20. That's the entire file. Claude reads that sentence, then acts on

The mechanism: read, follow, answer

[0:38]It directly. No branching, no extra steps invented along the way. Read the instruction, follow it, hand back the answer.

The anchor returns: same answer, nothing more

[0:46]Ask twice and you get the identical answer both times. That consistency is real. But, ask about Minecraft 1.21 instead, or emeralds instead of diamonds, and there's nothing left to reach for. The file only ever said the one thing. A Claude skill isn't Claude

Carry-out

[1:00]Knowing more. It's Claude reading one short file right before it answers, and it can't answer past what that file says. Your turn. Paste this into Claude. I'm

Your turn

[1:09]Going to hand you a short instruction file. Before you use it, tell me exactly what you'll read in it, and what you'll do with what's inside before you act. Watching it explain first is how you see the constraint for yourself. Claude mining Liam in for bear.

More from Claude

Humanitarians AI Lyrical Literacy Project