Waboom AI
AI Training
AI Automation
AI Voice Agents
Case Studies
Resources
Contact
09 888 0402
Back to BlogExplainers

What is a Claude Skill? The Plain-English Guide (2026)

Leonardo Garcia-Curtis13/05/2026
TL;DR

A Claude skill is a folder that teaches Claude a workflow once so you stop re-explaining yourself. It contains plain English instructions, lives on your computer or your Claude account, and works the same way across Claude Web, Desktop, and Code. The most common uses: writing in your voice, running your code reviews, generating your weekly report. You almost never write a skill by hand. A built-in tool called skill-creator generates it from your description. The teach-once-benefit-forever pattern is the operator move most Claude users miss.

What is a Claude Skill? The Plain-English Guide (2026)

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.

Leo running a live Waboom AI Claude Code workshop, attendees building skills together

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.

The anatomy of a Claude skill folder, with SKILL.md at the heart

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.

The same Claude skill works across Claude Web, Desktop, and Code. The install path is the only thing that differs.

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:

  • One-off questions ("what is the capital of Peru").
  • Tasks Claude already handles well without instructions.
  • Workflows that change every time.
  • 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 →
    LG

    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

    Related Pages

    AI Receptionist Australia

    24/7 inbound call answering with Australian accent.

    AI Sales Agent Australia

    Outbound dialling, qualification, meeting booking. Live in hours.

    AI Voice Agents for Mortgage Brokers AU

    Outbound to homeowners hitting fixed-term rollover.

    Related Articles

    Claude Skills vs MCP: which one do you actually need?

    Claude Skills vs MCP: which one do you actually need?

    Build your first Claude Skill in 15 minutes (no coding required)

    Build your first Claude Skill in 15 minutes (no coding required)

    Extended Thinking vs Web Search vs Research: which Claude mode to hit and when

    Extended Thinking vs Web Search vs Research: which Claude mode to hit and when

    Waboom AI

    Empowering New Zealand and Australian businesses with AI voice agents and automation that deliver real, measurable value.

    info@waboom.ai+64 9 888 0402
    Level 8, 139 Quay Street
    Auckland CBD, New Zealand

    Voice Agents

    • AI Voice Agents
    • AI Phone Answering
    • AI Virtual Receptionist
    • Medical Answering Service
    • Answering Service Australia
    • AI Sales Agent
    • Voice Agent Pricing
    • Listen to Voices
    • Real Estate Guide

    By Industry

    • Real Estate
    • Mortgage Brokers
    • Insurance Brokers
    • Property Managers
    • Medical Clinics
    • Dentists
    • Vets
    • Childcare + ECE
    • Car Dealerships
    • Construction + Builders
    • Electricians
    • Plumbers
    • HVAC
    • Accountants
    • Law Firms

    Workshops

    • AI Team Training
    • AI Strategy Workshop
    • AI Champion Workshop
    • Claude Team Training
    • Claude Code Workshop
    • Lovable Workshop
    • Free AI Workshop

    Automation

    • AI Automation
    • Microsoft Copilot Agents
    • Integrations

    Company

    • About Us
    • Contact
    • Partners
    • Resources
    • Blog
    • AI Agency NZ
    • AI Agency Australia

    Powered by leading AI technologies

    VAPIRetell AIOpenAIZapierMakeStripe

    © 2026 Waboom.ai. All rights reserved.

    PrivacyTermsSecurity