5 min read · The beginner explainer · Last updated 13 May 2026
Part of Learn Claude Code: The Complete Operator's Guide. For the operator's overview of Skills, Connectors, Cowork, and Artifacts, start there.
You have used Claude. Maybe a lot.
And every conversation, you re-explain the same thing.
Your writing voice. Your team's checklist. The format you want your reports in.
That is the problem a Claude skill solves.
You teach Claude the workflow once, you package it as a folder, and Claude knows it forever.
This post is the plain-English explainer. No YAML. No file-structure deep dive.
Just what a skill actually is, three real examples, and where to go next if you want one.
The simplest possible definition
A Claude skill is a folder containing one plain-text file of instructions that Claude reads automatically when you ask it to do something the skill is for.
That is it. That is the whole technical truth.
The folder can also contain a few optional things (scripts, reference docs, templates), but most skills are just one file in a folder.
The instructions are written in plain English. You almost never write them by hand.
A built-in tool called skill-creator writes them for you (more on that below).
Three real examples that explain it better than a definition
Definitions are abstract. Examples are not.
1. The voice writer
You upload three of your best emails. You tell Claude what your tone sounds like in plain English. The skill is called my-email-voice.
From then on, every time you say "draft a reply to this", Claude writes in your voice without you re-explaining.
No more "make it less robotic, no shorter, no less stiff" loop. You stopped having to teach it.
2. The branding guide
Your business has brand colours. A specific logo file. Font styles your designer chose. The exact tone you use in customer emails.
A skill called my-brand-guide knows all of it.
Need a PDF quote? Claude uses the right logo, the right colour, the right font. Need a one-pager? Same. Need an email reply? Same again.
The brand stays consistent across every document Claude touches, without you uploading the assets each time.
3. The weekly report
Pull last week's calls, group by outcome, write the summary in this exact format, save to this folder.
A skill called weekly-call-report does the whole thing on Monday morning.
Twenty minutes of admin becomes thirty seconds of prompting.
Three different shapes. Same idea: someone taught Claude the workflow once, and now they reap the benefit every single time.
This compounding is exactly what we walk attendees through at our Claude Code workshops in Auckland and Sydney. Most operators arrive having built zero skills and leave with three working ones, all chained.
The skills we actually run at Waboom AI
The three examples above are made-up to be relatable. Here is what is actually in production for us, because nothing teaches better than a real example.
The landing-page generator
One skill at Waboom has generated 25+ landing pages for different industries. The skill knows our copy structure, our voice markers, our brand colours, and the trust signals we use.
One ask. One landing page in our exact format. We wrote up the workflow in detail here.
The SEO checker
Before any blog post goes live, a skill called seo-check runs an 8-pass audit. Search intent, heading strategy, keyword coverage, link quantity, image cadence, fact density. The post does not ship until every pass clears.
Same script our agency would charge a client three hours for, on autopilot in 30 seconds.
The voice DNA enforcer
This article was written by Leo and edited by a skill. The skill has Leo's voice DNA baked in (no em-dashes, no AI-tells like "imagine this" or "moving forward", short fragments, UK spelling). It flags every breach before publish.
You are reading a sentence right now that probably got rewritten by it.
Three skills, one team, real work shipped this week. Same toolset you have. The only thing between you and your version is the next 60 minutes.
We teach this exact playbook in person at the Claude Code workshop. Hands-on, real laptops, you leave with working skills.
What is actually inside the folder?
The required bit is a single file called SKILL.md. It is plain text.
You can open it in any text editor and read it like a document.
The first few lines are a metadata header (the kind of thing a machine reads), and the rest is plain English instructions.
Optionally, the folder can also have:
- A
scripts/folder with code Claude can run. - A
references/folder with longer documents Claude can read when needed. - An
assets/folder with templates Claude can fill in.
For your first skill, you will not need any of those. One file. One folder. Done.
A dozen skills you could build today
If the three examples above are not pulling at anything you do every week, here is a longer list to spark it. These are all skills real operators are running right now (some of ours, some from Karol Zieminski's operator newsletter).
Alt-text generator for every blog image
LinkedIn teaser from a longer article
Receipt photo to expense entry
Spreadsheet data to trend summary
Meeting agenda from last week's notes
Competitor pricing pulled into a one-pager
Research synthesis across 10 sources
Sales-deck slides in your template
Email triage with draft replies in your voice
Long video transcript to social clips
Pull-request review against your team's checklist
Weekly status report from your call notes
Pick the one you already do badly or slowly. That is your first skill candidate.
Skills work everywhere Claude does
You can use Claude in three places: the web app at claude.ai, the desktop app on Mac or Windows, and Claude Code in your terminal.
Skills work the same way in all three.
The folder you build is identical. What changes is how you install it.
In the web and desktop apps, you upload the folder as a zip through Settings.
In Claude Code, you drop the folder into ~/.claude/skills/ on your computer.
One skill. Three surfaces. The skill follows you to wherever you are using Claude that day.
You do not write a skill by hand
This is the bit most tutorials bury.
They start by teaching you YAML frontmatter, kebab-case naming, valid description fields, and security restrictions.
You can skip all of it.
A built-in tool called skill-creator writes the file for you.
You describe the workflow in plain English. skill-creator asks you five questions, you answer in plain English, it produces a properly formatted skill, valid frontmatter, the lot.
You stay out of the technical bits.
If you can describe what you want, you can build a skill. The first one takes about 15 minutes.
We walk through building a real one in a separate tutorial post, and in Module 4 of the full course.
When you do not need a skill
Skills are for repeatable workflows.
If you only need Claude to do something once, just ask. A skill is overkill for:
A rough heuristic: if you have re-explained the same thing to Claude three times, that is a skill candidate. If you have only explained it once, it is not.
Skills versus MCP, in one sentence
People sometimes confuse Claude Skills with the Model Context Protocol (MCP). They are different things.
MCP gives Claude access to your external tools and data (Linear, Notion, Gmail, your CRM).
Skills give Claude the workflow knowledge for using those tools well.
Most beginners only need a skill. We unpack the difference properly here.
What to do next
You know what a skill is. The next move is to feel one in action.
The fastest path is our free Claude Skills 101 course. About one hour, broken into six short modules.
By the end you will have used a skill, built one, debugged a trigger problem, and shared one with your team.
If you are not ready for a course, the next post in this series walks through building your first skill in 15 minutes. Same idea, shorter format.
Self-paced
Six short modules. One hour total. Free. Use a skill, build one, debug a trigger, share it.
Start Claude Skills 101 →Hands-on with us
Live Claude Code + Skills workshop. Bring a real problem, leave with a working skill. APAC dates monthly.
See the workshop →Leonardo Garcia-Curtis
Founder & CEO at Waboom AI. Building voice AI agents that convert.
Ready to Build Your AI Voice Agent?
Let's discuss how Waboom AI can help automate your customer conversations.
Book a Free Demo


