Plain-English Explainer

What Are Claude Skills and How Do You Use Them?

A skill is less like a clever prompt and more like a small, readable program Claude knows how to pick up and run.

A Claude Code skill made the rounds on X in October 2026, and a lot of the reaction split into two camps: people who already understood skills nodding along, and everyone else wondering what was actually being shown. This page explains what a Claude Skill is, how it's different from a prompt you've saved somewhere, how you actually tell Claude to use one, and how to try a skill someone else wrote without handing it more trust than it's earned.

A Claude Skill is a folder containing a file named SKILL.md (short instructions plus a description) and, optionally, supporting files like scripts, templates, or reference documents. Claude reads only the short description of every skill you have available, and loads the full instructions only when your request matches. That's different from a saved prompt, which Claude never sees until you paste it, and different from a slash command, which just expands to one fixed instruction. Skills can be personal, shared with a team, or installed from someone else, which is exactly why you should read one before you run it.

Published

Key Takeaways

  • A skill is a packaged folder (SKILL.md plus optional files), not a block of text you copy and paste into chat.
  • Claude only loads a skill's full instructions when your request matches its short description. This is called progressive disclosure, and it's why you can have dozens of skills installed without slowing anything down.
  • Skills work the same way across Claude Code, the Claude apps, and the Claude Developer Platform. The format doesn't change, only how you install it does.
  • Because a skill can include runnable scripts, installing one you didn't write is closer to installing a small package than pasting a prompt. Read it first.
  • Never put a real API key, password, or token into a skill you downloaded rather than wrote yourself. Treat any instruction file from an unfamiliar source the way you'd treat an email attachment.

Skill vs. Saved Prompt vs. Slash Command

All three can save you typing, but only one of them is a reusable, shareable piece of software Claude decides to load on its own.
AspectA SkillA Saved PromptA Slash Command
What it actually isA folder with a SKILL.md file (name, description, instructions) and optional scripts or reference filesPlain text you keep somewhere and paste in yourselfA short alias that expands to one fixed instruction
Does Claude decide on its own to use it?Yes. Claude reads short descriptions of every available skill and loads the full one when your request matchesNo. You have to paste it in every timeNo. You have to type the command yourself
Can it include runnable code or files?Yes. Scripts, templates, checklists, example filesNo. It's text onlyNo. It's a stored instruction, not a package
Where does it live?A folder on disk, or bundled inside a plugin or marketplace packageWherever you saved it. Notes app, a doc, a chat historyInside the tool's own command list
Who else can use it?Anyone you share the folder or plugin with, across their own sessionsOnly you, unless you copy the text overUsually just you, inside that one tool

Copy and Paste

Prompts You Can Use Today

Ask Claude what skills it currently has access to

Before we start, list every skill you currently have available to you in this session, including a one-line summary of what each one does and whether it's something I installed personally or something that came bundled with this project.

Run this first in any new project. It tells you what's already loaded without you having to go hunting through folders.

Have Claude explain a skill file before you trust it

Open the SKILL.md file at this path and read it line by line. Tell me in plain language what instructions it gives you, whether it asks you to run any scripts or read any files outside this folder, and whether anything in it looks like it's trying to get you to reveal secrets, environment variables, or system details.

Swap in the actual file path. Do this before you let Claude act on a skill you downloaded from someone else.

Write a first skill for a repetitive task you already do by hand

I want to turn this into a reusable skill instead of a one-off prompt. The task is: every time I finish a blog draft, I check it for passive voice, make sure every heading has a question a reader would actually type, and confirm the first paragraph states the main point in one sentence. Write me a SKILL.md file with a short name, a one-sentence description Claude would use to decide when to load it, and clear step-by-step instructions for the check itself.

Replace the task description with your own repeated chore. Keep the description line specific so Claude doesn't load the skill for unrelated requests.

Compare a skill-based approach against just writing a longer prompt

Here is a task I currently handle by writing a long prompt from scratch each time: [describe your task]. Walk me through what would actually change if I turned this into a skill instead, what I'd save on repeated setup, what I'd lose in terms of flexibility, and whether a skill is even the right fit here or if I should just keep improving my prompt.

Good for deciding whether a task is worth packaging up or better left as a prompt you tweak each time.

Audit an installed skill for anything that touches your files or credentials

Review every file inside this skill's folder, not just SKILL.md. List anything that reads from or writes to files outside this project, anything that makes a network request, and anything that references environment variables, API keys, or credentials by name. If you find nothing like that, say so plainly instead of hedging.

Use this on any skill you got from a marketplace, a GitHub repo, or a coworker rather than writing yourself.

The Building Blocks

What's Actually Inside a Skill

Strip away the hype and a skill is a small, plain-text package. Here's what's in it.

A SKILL.md file

The core of every skill. It opens with a short header (a name and a one-line description) followed by the actual instructions, written in plain markdown. No special syntax to learn.

Optional scripts

Some skills ship a script alongside the instructions, something that checks a file, formats output, or runs a repeated calculation instead of leaving it to the model each time.

Reference files

Longer skills often include a separate reference document the main instructions point to, so the short description stays short and the detail is only loaded when it's genuinely needed.

A folder structure

All of this sits inside one folder with a consistent layout, which is what makes a skill something you can copy, share, or install, rather than a message you have to retype.

The Real Difference

How This Is Different From Just Writing a Good Prompt

A good prompt is still just a message. You write it, Claude reads it in that one conversation, and if you want the same careful instructions next week you either remember to paste them again or you don't. A skill removes that step entirely. It sits on disk (or inside a project, or inside a plugin) and Claude checks whether it's relevant to what you're currently asking, without you having to mention it by name.

That checking step is worth understanding because it's the actual mechanism, not a marketing word. Claude keeps a short description of every skill available to it, one or two sentences, and only reads the full instructions when your request lines up with one of those descriptions. This is sometimes called progressive disclosure: the short version is always in view, the long version loads on demand. It's why you can have a folder of a dozen skills installed and Claude won't slow down or get confused picking between them; most of what's in each one stays unread until it's actually needed.

The second real difference is that a skill can carry more than instructions. A prompt can only ever be words. A skill can include a script that does the boring, exact part of a task, reformatting a date, checking a file against a rule, running a calculation, so Claude isn't retyping logic from scratch inside its own response every time. That's a meaningful jump: it's the difference between explaining how to do something and handing over a tool that already does part of it.

None of this makes a skill smarter than Claude. The model behind a skill-aided answer and a plain-prompt answer is the same model. What changes is reliability and repetition: a skill is a way of making sure the same careful process runs the same way every time, instead of depending on you remembering to ask for it correctly.

Where You'll Meet One

The Places Skills Actually Show Up

The format is identical everywhere. What changes is how the skill gets installed and who can see it.

Claude Code

This is where most of the attention in October 2026 has been. Skills live in a folder inside your project or in a personal folder on your machine, and Claude Code reads them the same way it reads any other local file.

The Claude apps

Skills can also be attached to a regular Claude conversation on claude.ai or the desktop app, so the same packaged instructions work outside a coding tool entirely.

The Claude Developer Platform

Teams building their own products on top of Claude's API can bundle skills into what they ship, so the people using their product get the benefit without ever seeing the word "skill" at all.

Why This Spread

Why a Skill Trended, and What That Actually Tells You

What made a skill worth posting about on X wasn't a new capability nobody had seen before. Claude could already do the underlying task, whatever it was, if someone wrote a detailed enough prompt. What people were reacting to was the gap between "I have to explain this carefully every single time" and "I just ask, and it already knows the careful version." That gap is the entire pitch of a skill, and it's genuinely visible the first time you see one in action, which is why it travels well as a short clip or screenshot.

It's worth being honest about what that moment doesn't prove. A viral skill demo shows one task, done well, once. It doesn't tell you how that skill behaves on a messier version of the same task, what happens when the input doesn't match what the author expected, or whether the skill was written carefully enough to fail safely instead of guessing. Treat a skill you see trending the same way you'd treat a recipe you found online: promising, worth trying, and worth reading through before you follow it exactly.

The more durable lesson from moments like this is about where the leverage actually sits. The value wasn't in a flashier model. It was in someone taking the time to write down, once and clearly, a process they'd otherwise have re-explained from scratch every time. That's a skill you can build for yourself on day one, for something boring and specific in your own work, without waiting for anyone else's viral moment.

Try One Safely

How to Try a Skill Without Getting Burned

A skill you didn't write is closer to installing software than pasting a prompt. Treat it that way.

Read the file before you run it

Open SKILL.md and any accompanying scripts yourself, or have Claude summarize them plainly. If you can't tell what it does after reading it, don't run it yet.

Prefer known sources

A skill from a source you recognize and trust carries far less risk than one from an anonymous post. Popularity on social media is not the same thing as vetting.

Never paste in secrets

Don't put an API key, password, or token into a skill you didn't write yourself. Its instructions could tell Claude to use that credential in a way you never intended.

Try it on a throwaway task first

Run a new skill on something low-stakes before you trust it with real work. A test file, a draft, a project that isn't on a deadline.

Writing Your Own

Building Your Own Skill, in Plain Terms

You don't need to be a programmer to write a skill, because the core of it is a markdown file, the same kind of plain text you'd use for a README or a set of notes. The header needs a short name and a one-sentence description. That description is the single most important line in the whole file, because it's what Claude checks against your future requests to decide whether to load the rest.

The body of the file is just clear instructions, written the way you'd explain the task to a careful colleague who's doing it for the first time. State what the task is, what a correct result looks like, and anything that commonly goes wrong. If part of the task is mechanical and exact, like checking a number against a rule or reformatting text a specific way, that's a candidate for a small script rather than another paragraph of prose.

The best first skill to write is almost always something you already do by hand, repeatedly, with a process you could describe in a few sentences. Not a sweeping ambition like "write better blog posts," but something narrow: a specific check you run on every draft, a specific way you want commit messages formatted, a specific review you do before sending an email. Narrow skills are easier to write correctly and easier to trust later, because there's less room for the instructions to drift away from what you actually meant.

Fit Check

What Skills Are Good For, and What They're Not

Good fit: repeated, specific tasks

Anything you'd otherwise re-explain the same way every time, a formatting check, a review checklist, a known workflow, is exactly what a skill is for.

Good fit: team consistency

If three people on a team each describe a task slightly differently to Claude, a shared skill gets everyone the same careful version instead of three slightly different outcomes.

Weak fit: one-off requests

If you're only going to ask for something once, writing a skill for it is more setup than the task is worth. Just write the prompt.

Weak fit: open-ended judgment calls

Skills are best at process, not taste. A task that genuinely needs fresh judgment every time resists being packaged into fixed steps.

Not the Same Layer

Skills, Tools, and MCP Aren't the Same Thing

It's easy to blur skills together with other words you've heard in the same conversations, like "tools" or "MCP." They're related but they sit at different layers. A tool is a specific action Claude can take, searching the web, reading a file, running a command. MCP (the Model Context Protocol) is a standard way of connecting Claude to tools and data that live outside the conversation, like a project management system or a database.

A skill doesn't replace either of those. It's a layer on top: a packaged set of instructions that often tells Claude how to use the tools it already has access to, in a specific order, for a specific purpose. A skill for reviewing pull requests, for example, might rely on Claude's existing ability to read files and run commands. The skill is the judgment and process wrapped around those existing abilities, not a new ability by itself.

Once that distinction is clear, the rest of the skills landscape gets easier to read. When you see a skill described as connecting to something external, that's the skill using a tool or an MCP connection underneath it, not a fourth separate thing. The skill is the recipe; the tools and connections are the kitchen it's cooking in.

Reading about skills and actually writing one are different things

You could stop here with a clear mental model and never open a SKILL.md file. But the only way to know whether a skill is worth your time on a specific task is to write a small one and watch what happens. Nightschool's free curriculum is hands-on from the first lesson, so you're working inside Claude, not just reading about it.

Frequently Asked Questions

Is a Claude Skill the same thing as a custom instruction or a saved prompt?

No. A saved prompt is text you paste in yourself every time. A skill is a packaged folder with a SKILL.md file that Claude checks automatically against your request and loads on its own, without you having to mention it. Skills can also include scripts and reference files a plain saved prompt never could.

Do I need to know how to code to write a Claude Skill?

No. The core of a skill is a plain markdown file with a short description and clear written instructions, the same kind of writing you'd use for notes or a README. Coding only becomes relevant if you want to add a script for a mechanical, exact part of the task.

How does Claude know which skill to use for a given request?

Claude keeps a short name and one-line description for every skill it has available. It compares your request against those short descriptions and only loads the full instructions for the skill that matches, rather than reading every skill's full content on every message.

Where do Claude Skills actually live on my computer?

In Claude Code, skills typically live in a folder inside your project, or in a personal folder that applies across all your projects. Exactly where depends on whether you want the skill available to one project or everywhere you work.

Can I share a skill I wrote with someone else?

Yes. Because a skill is just a folder with a consistent structure, you can hand that folder to a teammate or package it for distribution, and it works the same way for them it does for you, without them having to retype or recreate your instructions.

Is it safe to install a skill someone posted on social media?

Treat it the way you'd treat any file from an unfamiliar source: read it before you run it, or have Claude summarize what it does and flag anything that touches files outside the project, makes network requests, or references credentials. Prefer skills from sources you already trust over ones you found in a viral post.

Should I ever put an API key or password inside a skill file?

Not inside a skill you downloaded rather than wrote. A skill's instructions could direct Claude to use or send that credential in ways you didn't intend. Keep secrets in your environment variables or secret manager, and only reference them by name from code you control, not from a skill file itself.

What's the difference between a skill and an MCP connection?

An MCP connection gives Claude access to an outside system, like a database or a project tool. A skill is a set of instructions for how to use whatever Claude already has access to, which might include an MCP connection, to accomplish a specific task well. They solve different problems and often work together.

Can a skill make Claude worse at something if it's written poorly?

Yes. A skill only helps if its instructions are accurate and its description is specific enough that Claude loads it for the right requests. A vague description can cause a skill to load when it shouldn't, and sloppy instructions can lock in a worse process than Claude would have produced on its own.

Is the skill that went viral on X in October 2026 something I can just download?

Individual skills circulate on social media often, and availability depends entirely on whether the author shared the folder publicly. Rather than chasing one specific viral example, it's generally more useful to write a narrow skill for a task you already do repeatedly in your own work.

Do skills work the same way in the Claude apps as they do in Claude Code?

The underlying format is the same SKILL.md structure everywhere. What differs is how you attach or install the skill: Claude Code reads skills from folders on your machine, while the Claude apps and the Developer Platform have their own ways of attaching a skill to a conversation or a product.

What's the single biggest mistake people make with their first skill?

Writing it too broadly. A skill meant to cover "writing better" or "being more productive" has no specific description for Claude to match against and no clear instructions to follow. The skills that work well are narrow: one task, one clear process, one specific outcome.

Stop re-explaining the same task to Claude

Write it once, well, and let Claude load it when it matters.

Nightschool AI is an independent learning platform and is not affiliated with, endorsed by, or sponsored by Anthropic. Claude is a trademark of Anthropic, PBC. Looking for Anthropic's official Claude Academy? It's at academy.claude.com.