Claude, Mining.

The video uses a skill called mining, whose SKILL.md is one sentence about diamonds in Minecraft 1.20, to show what a Claude skill really is. Claude reads the file and answers from it, and cannot answer past what it says.

1:25 video3 min readWatch on YouTube

The common guess is that a skill means Claude has built-in knowledge, as if a skill unlocked a new ability the way a plugin might. The video says it does not work that way. A skill is a file that Claude reads, and it uses a deliberately tiny example, a skill named mining, to show exactly what that means.

The naive framing

The starting assumption is that Claude "just knows" something like Minecraft trivia, and that having a skill for it means built-in knowledge. The video's answer is simple: it reads a file. The question it then asks is what is actually happening when Claude reads a skill.

A folder with one file

A Claude skill is a folder that Claude checks before it acts. This one is called mining. Open it, and there is exactly one file inside, SKILL.md.

The tempting wrong guess

One tempting explanation is that Claude was already trained on years of Minecraft guides, and the skill merely gives it permission to say what it already knows. The video sets that aside by opening the file.

The anchor: the entire file is one sentence

Inside SKILL.md there is no permission statement, no reasoning, and no guide to cross-reference. There is a single sentence about where diamonds spawn in Minecraft 1.20. That is the entire file.

Read, follow, answer

Claude reads that sentence and acts on it directly. There is no branching and no extra steps invented along the way. The mechanism is to read the instruction, follow it, and hand back the answer.

Consistent, and bounded

Ask the same question twice and you get the identical answer both times. The video says that consistency is real. But ask about Minecraft 1.21 instead, or about emeralds instead of diamonds, and there is nothing left to reach for, because the file only ever said the one thing.

What the video does not claim

It does not say every skill is this small. Mining is used because it makes the point vividly, not because all skills are one sentence. It also gives no verdict on whether mining is a well-built skill, and it does not claim Claude is otherwise ignorant of Minecraft. The claim is narrower: for this skill, the answer comes from the one sentence in its file.

Key takeaways

  • A Claude skill is a folder that Claude checks before it acts.
  • The mining skill contains one file, SKILL.md, holding a single sentence about where diamonds spawn in Minecraft 1.20.
  • Claude reads the instruction, follows it directly and returns the answer, with no invented steps.
  • Asking twice gives the same answer, which is a real benefit.
  • A skill is not Claude knowing more; it is Claude reading one short file right before it answers.
  • Questions the file does not cover, such as another version or another resource, have nothing to draw on.
  • Claude cannot answer past what the file says.

Try it yourself

Take a short instruction you have on hand, such as a note, a checklist or a short document, rather than the Minecraft example. Then ask Claude: "I'm 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." Having Claude 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

Carry-out

[0:59]Claude skill isn't Claude 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 Basics

Humanitarians AI Lyrical Literacy Project