1. What Is a Skill
Tommy comes back to Alex already with a built Snake. It slithers, eats, grows — but it’s gray, boring, the buttons are plain, the font is corporate. Nothing “feels alive.”
“Here.” He points at the screen. “It works. But it looks cheap. I already asked Sam to make it beautiful — it got a little better, but it’s still clunky. It’s like he does not know what I mean by ‘beautiful.’”
“And he really does not know,” Alex agrees. “‘Beautiful’ means something different to everyone, and explaining it from scratch every time is torture. Good news: quality can be improved in one move. You do not need to learn CSS or spell out every time what beautiful means. Just give the AI agent a ready-made skill.”
“A skill? What kind of beast is that?”
“A skill is a ready-made ability you put on an agent,” Alex explains. “Imagine a packaged instruction: ‘when asked to make it beautiful, do it like this: soft shadows, smooth transitions, thoughtful fonts, coordinated colors.’ Set that instruction once — and the agent applies it by itself, so you do not need to explain it again every time.”
Tommy sees where this is going:
“So it fixes exactly my problem. I keep writing from scratch every time what ‘beautiful’ means.”
“Exactly. With a skill, that is said once and packaged. After that it works by default. Before, you explained it again in every request — now you explained it once, and that’s it.”
And this is where Tommy really gets into it. Why learn the ability himself if he can equip the tool with it? He does not need to grind CSS himself — he puts the CSS ability on the agent. He literally straps a superpower onto Sam.
“Hold on, Alex.” He leans forward, eyes bright. “So I do not go to the gym, I go straight to the store for biceps? Buy it, put it on, and walk around jacked? That is cheating in its purest form. I like it.”
“You could say it that way.” Alex chuckles. “Only it’s not you who is jacked, it’s Sam. You are the one who hands out the muscles.”
“And I do not need them myself. I need it to look like it’s me. That is what I love.”
2. Where the Skill Lives and What It’s Made Of
“So what, is this some kind of magic in the cloud?” Tommy presses. “Where does it even live?”
“No magic at all. A skill is just a folder with a file right inside your project.” Alex shows the path:
.claude/skills/web-design/SKILL.md“Let me explain each part of the path,” he suggests. “The service folder .claude, inside it skills, inside that the skill’s own folder, I named it web-design, and inside it the file SKILL.md. A plain text file. Open it — here’s what is inside:”
---
name: web-design
description: Makes web interfaces beautiful — modern CSS, smooth animations,
premium palette. Use when asked to “make it beautiful / stylish”.
---
# Web Design
When designing, use: soft shadows, smooth transitions, thoughtful typography,
coordinated palette. Animations — on hover and when elements appear.“See the top line, description? That is the most important thing. By it, the AI agent decides on its own when to put the skill to work. You wrote in the description ‘use when asked to make it beautiful’ — and then, when you say ‘make it beautiful,’ the AI agent remembers this skill and brings it into action. You do not need to specify it manually — it triggers automatically.”
Tommy tries to sum it up:
“So I do not press a button, and the agent figures out from the description that this skill is needed here?”
“Exactly. And you take a ready-made skill from the catalog, or someone gives it to you — and you just drop the file into the right folder. Zero code on your side. Zero detailed instructions. Everything works automatically.”
3. The “Before and After” Magic on One Request
“Enough theory.” Alex opens the terminal. “Let’s see the difference on one and the same request. First — without the skill. Go ahead.”
Tommy writes:
Sam, make my Snake very beautiful.The AI agent does its best — tweaks the colors, tweaks the font. Better, but still cheap. It does not have a clear idea of what “beautiful” means specifically for Tommy.
“See? Weak. Now let’s use a skill. In principle, you can write the SKILL.md file yourself, but usually nobody does that. Right now there are literally millions of ready-made skills. There are ready-made catalogs on the internet. Almost like an app store, just for skills.”
“Can I just copy the text from the chat that you explained to me recently? About description.”
“Sure. Put this file in the .claude/skills/web-design/ folder. The agent picks up these files on the fly — save it, and the skill is already in play, you do not even need to restart anything. One caveat: if the folder .claude/skills/ did not exist when you started the session, then you will have to restart the session — it will not see it on the fly. You can check that the skill loaded like this:”
/skills # show the list of loaded skills — web-design should appearweb-design pops up in the list. Loaded.
“And now — the very same request. Word for word.”
Tommy repeats:
Sam, make my Snake very beautiful.Sam works for about 5 minutes, and finally the page opens in the browser. And this is where Tommy’s jaw drops.
The Snake stops twitching from cell to cell and glides smoothly. Soft shadows appear, a premium palette, neat fonts, on the apple — a soft effect. The same game, the same logic — but the gray toy suddenly looks like something from an upscale store. Tommy never explained what “beautiful” meant. It was already packaged into the skill.
“Wait. The request was exactly the same. I didn’t do anything. What changed?”
“What changed was not in your head.” Alex catches the moment and teases him. “What changed was the AI agent. You did not figure out CSS in a minute. You gave the AI a ready-made ability — and the result immediately improved in quality. That is what a skill in action looks like.”
He adds one more thing to drive the point home:
“By the way, you can trigger a skill explicitly, by name, if you want to be sure:”
/web-design“But usually you do not need to — it triggers on its own when needed.”
4. What Exactly the Skill Affects
“Listen, did it break anything in the logic on me?” Tommy grows wary. “The Snake still slithers correctly, right?”
“And this is where what we discussed this morning comes in. Remember the three layers? HTML — structure, CSS — appearance, JS — behavior. So the skill improved only the CSS layer — the visual side. The logic — how it slithers, how it eats the apple, how it grows, that is JS — it did not touch it at all. The game works exactly as before, it just looks expensive now.”
Everything clicks for Tommy:
“Ah, so it dressed up the snake like you said this morning. It did the renovation and did not touch the wiring.”
“Exactly. The skill targets a specific layer. Want to improve the look — take a design skill, it works with CSS and does not interfere with logic. ‘Works’ and ‘looks’ are different layers, and you can level them up separately.”
“Then I have a second question — where do I get these skills? You said there are millions of them.”
“Tommy, you are going to like my answer,” Alex says with a grin. “You can always ask the AI agent to look for skills that fit you, or to install the skill you need.”
“Wait.” Tommy coughs. “Do you mean I no longer have to download and install these skills myself? I can just tell the agent to install this or that skill, and it will do it itself?”
“That is exactly what I am telling you,” Alex teases him. “We live in the twenty-first century. AI can literally do everything.”
5. One Skill — but Can You Have a Bundle?
Tommy is already carried away.
“Listen, can you do not one skill, but a whole bunch? All at once?”
“You can.” Alex slows down without turning around. “Sometimes it works that way: for an entire topic, they install a whole bundle of ready-made skills at once. But that is a different story; we will get to it. For now, remember the simplest thing: put in a skill — the agent picked it up itself — the result got better. You have already put one skill on.”
Tommy drinks his third cup of coffee and cannot stop: “I keep underestimating AI. And every time I become convinced that the hardest things can just be asked for.” Since the agent with a skill knows on its own what is beautiful, why keep it on a leash at all? Almost without looking, he tosses this to Sam:
Go ahead and do whatever you want, as long as it comes out beautiful. I give you permission.
Sam, squeeze the maximum out of these skills. Do not stop until you have improved everything.“Come on, Sam,” he says out loud, slouching in the chair like a lord. “Carte blanche. Make a masterpiece, and I will finish my coffee.”
And he gets pure enjoyment: the less he decides himself, the more magic spills out.