Part 0 · AI Without the Fog

What Is This "Skill" Everyone's Talking About?

A cheat sheet of experience written for AI. Play the comparison: the butler without it runs 4 extra trips; with it, done in one

THE QUESTION THIS PAGE ANSWERS

ANSWER FIRST

What Is This "Skill" Everyone's Talking About?

A cheat sheet of experience written for AI. Play the comparison: the butler without it runs 4 extra trips; with it, done in one

DECISION RULE

Make the claim earn its place. Use this page as a decision aid, not a definition to memorize. Connect the idea to one real task, one observable result, and one failure that would change your mind.

TRY NEXT

Write one question you could answer with evidence after trying this idea.

WATCH FOR

A conclusion that sounds complete but leaves the key assumption untested.

One-sentence answer

A Skill is a cheat sheet of experience written for AI: a plain text file (usually called SKILL.md) that tells the AI, in everyday language, "when you meet this kind of task, do this first, then that, and watch out for this." It's not some new technology — but it turns an AI that "comes back to ask you four times" into one that "finishes everything in a single trip".

Watch a demo · Send the AI butler to bring in the laundry

Same task: "Go to the balcony and bring in the laundry." See how differently the AI butler works without the cheat sheet versus with the cheat sheet. Click below to switch and compare.

Its secret · It's just a "cheat sheet" like this

The whole secret behind that "good loop" lives in this one file. Look closely: not a single line of code — it's all plain everyday language. That's exactly why we say anyone can write one.

📄 SKILL.md — Balcony laundry cheat sheet
When to use this cheat sheet
Whenever the owner mentions "bring in the laundry", "balcony", or "hanging clothes out to dry".
How to do it
Step 1: Before heading out, think about what might be on the balcony (shirts, pants, socks, toys…)
Step 2: Bring in everything you can in one go — don't run back and forth for each item
Step 3: If you see the plants, check whether they need watering while you're there
Step 4: Come back and report with a simple "All done"
The most important principle
Finish it all in one trip — don't come back to ask after every single step.
Why it's suddenly so popular
🤝

Everyone adopted the same kind of cheat sheet

Claude, Cursor, Copilot and other mainstream AI tools have all adopted the same simple format (that SKILL.md file). Write one cheat sheet and it works everywhere — and the ecosystem took off overnight.

✍️

Anyone can write one

No programming needed — it's just writing your experience down in plain language. However you'd walk a new colleague through a task is exactly how you write the cheat sheet. If you can write a handover doc, you can write a Skill.

💎

For the first time, experience can be "installed" into AI

A veteran's know-how used to pass only by word of mouth; now you write it into a cheat sheet, the AI reads it, and it just knows. Your experience becomes the AI's capability — that's the real reason everyone's excited.

You may already be using this without realizing it: the "agents", "bot templates", and "one-click XX assistants" inside many AI apps are, at heart, pre-packaged Skills — someone wrote the cheat sheet for you. When you want the AI to work your own way, you can write one yourself. Chapter Seven of this site has a whole lesson taking you deep into Skill design.

The handoffs inside “Watch a demo · Send the AI butler to bring in the laundry”

“A Skill is a cheat sheet of experience written for AI : a plain text file (usually called SKILL.md) that tells the AI, in everyday language, "when you meet this kind of task, do th…” shows that an Agent is not defined by the model alone. Each handoff between model, context, tools, state, permissions, and people affects both progress and recovery.

Write the state before adding capability

Starting from “Same task: "Go to the balcony and bring in the laundry." See how differently the AI butler works without the cheat sheet versus with the cheat sheet .”, split the workflow into starting state, next action, tool result, state update, and stop condition. Debugging then means finding the first lost piece of information or authority instead of saying vaguely that the model “got worse”.

  • Skill = a cheat sheet of experience written for AI : a plain-language text file, not new technology
  • The problem it solves : the AI thinks things through before heading out, finishes in one trip, no back-and-forth
  • Why it's popular : mainstream tools agreed on one format + anyone can write one + experience becomes reusable

A happy path is not reliability

Use “A veteran's know-how used to pass only by word of mouth;” to replay one successful and one failed run. Record the context, tool result, and owner at each turn; the workflow is maintainable when a second person can follow it without the original builder.

From “Watch a demo · Send the AI butler to bring in the laundry” to “Its secret · It's just a "cheat sheet" like this”

“Watch a demo · Send the AI butler to bring in the laundry” grounds the problem in “Same task: "Go to the balcony and bring in the laundry." See how differently the AI butler works without the cheat sheet versus with the cheat sheet . Click below to switch and compare”. “Its secret · It's just a "cheat sheet" like this” then moves it toward “The whole secret behind that "good loop" lives in this one file. Look closely: not a single line of code — it's all plain everyday language . That's exactly why we say anyone can write one”. Together, they show that the lesson is not just a conclusion to remember, but a claim with conditions.

Carry the judgment into the next situation

When analyzing an Agent, trace state, action, tool result, and next step in order. Each handoff should explain where information came from, who confirmed it, and where failure stops.

  • “Watch a demo · Send the AI butler to bring in the laundry”: Same task: "Go to the balcony and bring in the laundry." See how differently the AI butler works without the cheat sheet versus with the cheat sheet . Click below to switch and compare
  • “Its secret · It's just a "cheat sheet" like this”: The whole secret behind that "good loop" lives in this one file. Look closely: not a single line of code — it's all plain everyday language . That's exactly why we say anyone can write one
  • “The closing point”: You may already be using it : all those "agent templates" are pre-packaged Skills under the hood

The final “The closing point” brings the discussion to “You may already be using it : all those "agent templates" are pre-packaged Skills under the hood”. The useful thing to carry forward is knowing which judgments must be revisited when input, scale, or risk changes.

✅ What this page wants to share with you

  • Skill = a cheat sheet of experience written for AI: a plain-language text file, not new technology
  • The problem it solves: the AI thinks things through before heading out, finishes in one trip, no back-and-forth
  • Why it's popular: mainstream tools agreed on one format + anyone can write one + experience becomes reusable
  • You may already be using it: all those "agent templates" are pre-packaged Skills under the hood
Mark as learned Your reading progress updates automatically
← PreviousNext →

Keep reading

The next useful article in the thread.

ARTICLE DISCUSSION

Leave one useful thought here.

Keep the idea that clicked, the question that stayed open, or a small note for the next learner.

Discussing What Is This "Skill" Everyone's Talking About? AI Without the Fog
3discussionsArticle discussion · synced with the Circle
View in the learning circle
AM
Asha MorganContent editor
INSIGHTField note

I turned one judgment from this article into a small experiment I could run today. Knowing what to observe next is more useful than simply remembering the conclusion.

ARTICLE DISCUSSION7 helpful
LH
Lin HarperIndie developer
INSIGHTInsight

After reading this, I first looked for the conditions behind the idea instead of copying the method into a project. That order made the later trade-offs much clearer.

ARTICLE DISCUSSION5 helpful
KM
Kiki MooreProduct operations
QUESTIONQuestion

When this judgment reaches real work, which constraint should be added first? I am curious which step matters most between reading and the first practical attempt.

ARTICLE DISCUSSION4 helpful