Claude Skills: A Practical Guide for Business Owners
What they are, how to build them, and real examples from consulting, content, and operations.
A Claude Skill is a folder containing a SKILL.md file with instructions that teach Claude how to do a specific job. It works across Claude.ai, Claude Code, and the API without modification.
Think of it this way: without a skill, Claude is a brilliant generalist that guesses what you want. With a skill, Claude follows the exact method you’ve defined — your frameworks, your voice, your standards. Same AI, completely different output.
Most tutorials focus on skills for developers. This guide is for business owners who want to use Claude as a genuine thinking partner and production tool — not just a code generator.
How Claude Skills actually work
Every skill is a folder with a SKILL.md file inside it. The file has two parts:
YAML frontmatter (between --- markers) that tells Claude the skill’s name and when to use it. The name uses kebab-case (e.g. sparring-partner). The description is critical — Claude uses it to decide whether to activate the skill for the current task.
Markdown instructions below the frontmatter that tell Claude what to do when the skill is invoked. This is where your method, framework, and quality standards live.
You can also add reference files (like REFERENCE.md) for supplemental information that Claude pulls in when needed.
Where skills live:
- Claude.ai: Upload as a ZIP file via Customize > Skills. Click the “+” button, then “+ Create skill.”
- Claude Code: Place in
~/.claude/skills/and Claude reads them automatically. - API: Same SKILL.md format, loaded programmatically.
The same skill works everywhere. Write once, use across all Claude surfaces.
Skills vs Projects: when to use which
This is the question everyone asks. The official answer from Anthropic is clear:
Projects give Claude persistent context about a specific body of work. Your company, a client, a research initiative. Everything in the project’s context window is loaded into every conversation.
Skills teach Claude how to do something. A project might contain all the background on your product launch. A skill teaches Claude your writing standards or your code review process.
The practical test: if you find yourself copying the same instructions across multiple projects, that’s a signal to create a skill instead.
I use both together. My Claude Projects have Soul (who I am) and Context (what’s happening). My skills have methods (how to do specific tasks). The project tells Claude who it’s working with. The skill tells it how to work.
What goes inside a SKILL.md file
Every skill I build follows the same structure. The frontmatter handles identity; the body handles method:
The body of the SKILL.md typically includes:
- PurposeOne paragraph. What is this skill for? When should Claude activate it?
- Expert InstructionsThe core method. How to actually do the thing well. Built from your own expertise or extracted from a trusted source.
- PhasesHow the skill operates step by step. Usually: gather context, execute, refine.
- Output FormatWhat the result should look like. Length, structure, style constraints.
- Quality RulesWhat to avoid. The guardrails that keep output from drifting into generic territory.
Anthropic’s advice on descriptions: make them “a little bit pushy.” Claude has a tendency to under-trigger skills, so a clear, specific description helps it recognise when to load yours.
Real skills I use every day
Most skill tutorials show developer examples. Here are skills built for business work — consulting, content creation, and operations:
Two modes: exploration (build on ideas) and sparring (challenge assumptions, stress-test logic).
Guided decomposition: surface assumptions, break to fundamentals, rebuild from truth.
Full content engine: audience psychology, five post types, three variants per draft.
Shared rules for tone, archetypes, and platform mechanics across all writing.
Run on interview transcripts. Extracts company profile, team signals, ICP fit.
Pulls verbatim customer quotes by theme and persona. The exact words matter.
Creates testable GTM statements with confidence scores and kill criteria.
Updates the "Current Truth" document based on accumulated evidence.
The thinking skills (sparring partner, first principles) are deeply personal — built from how I actually make decisions. Nobody else’s version would work the same way for me.
The production skills (LinkedIn writer, copywriting fundamentals) are more transferable. The GTM system skills (ICP extractor, pain language miner) were built for a specific client project but the patterns apply to any B2B operation.
This is one of the things I do for clients. I sit with them, extract their expertise through conversation, and build skills that capture how they actually work. Their objection handling. Their pricing logic. Their voice. Packaged as skills that any AI tool can use.
“The skill file is the difference between a stranger and a colleague who knows how you work.”
How to build your first skill
Pick something you do repeatedly and explain well. The task you find yourself describing to every new team member, every new client, every new project.
Write out how you do it: the steps, the rules, the examples, the things to avoid. Put it in the SKILL.md format with a clear name and description. Upload it to Claude.ai or drop it in your skills folder.
Start with one skill. Use it for a week. Notice what’s missing — Claude will show you by getting things wrong in specific, fixable ways. Update the instructions. The first version is never the best, but it’s infinitely better than no version.
Your skill library grows naturally from your work. Every project, every client, every repeated task is a candidate. Over time, you stop building from scratch and start assembling from parts.
That’s when AI stops feeling like a tool and starts feeling like a team.
What changed in Skills 2.0 (March 2026)
The March 2026 update added three significant capabilities:
- Built-in evals. Test your skill’s output quality against specific criteria. This means you can measure whether v2 of a skill actually performs better than v1.
- A/B testing. Run two versions of a skill side by side and compare results. Useful for iterating on content creation or analysis skills.
- Trigger optimisation. Improved how Claude decides when to activate a skill. The progressive disclosure system is now smarter about matching tasks to skills.
For business users, the most impactful change is progressive disclosure. You can now maintain a large library of skills without worrying about context window limits. Claude reads the skill descriptions, decides which ones are relevant, and loads only those. Dozens of skills, zero overhead.
Frequently asked questions
What are Claude Skills?
Folders containing a SKILL.md file with instructions, scripts, and resources that Claude loads dynamically when relevant. They work across Claude.ai, Claude Code, and the API. Skills teach Claude how to do specific jobs repeatably — from writing in your voice to analysing data using your workflows.
How do I create a Claude Skill?
Create a folder with a SKILL.md file. Add YAML frontmatter with a name (kebab-case) and description (up to 200 characters). Below the frontmatter, write markdown instructions for what Claude should do. Upload as a ZIP to Claude.ai, or place in ~/.claude/skills/ for Claude Code.
What’s the difference between Skills and Projects?
Projects give Claude persistent context about a body of work (your company, a client). Skills teach Claude how to do something (your writing process, your review framework). If you’re copying instructions across multiple projects, make it a skill instead.
What are the best skills to start with?
Start with the task you explain to people most often. Good first skills: a writing style guide, a decision-making framework, a content creator for your format, or a client onboarding checklist.
Do skills work in both Claude.ai and Claude Code?
Yes. The same SKILL.md file works across Claude.ai, Claude Code, and the API without modification. Claude Code adds advanced features like subagent execution.
What changed in Skills 2.0?
The March 2026 update added built-in evals, A/B testing, and trigger optimisation. The biggest practical change: progressive disclosure means Claude only loads skills relevant to the current task, so you can maintain a large library without context window overhead.
This is part of a series on building AI systems for business. Start with Meta-Prompting 101 for the method, then Claude Projects for the environment. Skills are the tools.
The full picture
Danny builds AI systems for NZ businesses. He uses Claude Skills daily for consulting, content creation, and client operations. Based in Auckland.
Want skills built from your expertise?
I sit with you, extract how you actually work, and package it as skills that make AI sound like you.
Start building \u2192More field notes
Social Media Management in 2026
Interest-based algorithms, the content pyramid, AI tools, and what it costs.
ReadHow I Built a 20-Prompt System to Run a Go-To-Market Operation
14 interviews, 4 layers, and a living document that replaced gut feel with evidence.
ReadHow to Build a Business Knowledge Base with AI
Turn two conversations into a structured knowledge base that powers your website, emails, and content.
ReadShift Down, Not Left
Why platform engineering replaces shift left as the structural fix for developer burnout.
ReadI Built a Scaling Dashboard for a $200K/Month UGC Agency
Interactive economics dashboard + scaling roadmap for a creative agency.
ReadWhen Cold Outreach Hits a Wall
How content-led GTM replaced cold outreach for a B2B platform engineering company.
ReadWhy I’m Betting on Vercel’s AI Cloud
$20/month unlimited sites and what it means for small businesses.
ReadMeta-Prompting 101
The method behind AI systems that sound like you.
Read