mohios
← Back to field notes

Claude Skills: A Practical Guide for Business Owners

What they are, how to build them, and real examples from consulting, content, and operations.

Danny Holtschke
Danny Holtschke·April 8, 2026 · 10 min read · AI Systems
Series: 3 of 4
Meta-Prompting 101Claude ProjectsSkillsKnowledge Base

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.

The key insight from Anthropic: skills use progressive disclosure. Claude doesn’t load every skill into the context window at once. It reads the names and descriptions, then loads only the skills relevant to the current task. This means you can have dozens of skills without overwhelming the context.

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.

Soul
Who you are. How you think. Stable.
Context
What's happening now. Fluid.
Identity & Situation
Project Instructions
Read Soul. Read Context. Ask, don't assume. Then respond.
The Glue
sparring-partner.md
first-principles.md
linkedin-writer.md
icp-extractor.md
truth-updater.md
Skills (.md files)
Claude reads all layers before every conversation

What goes inside a SKILL.md file

Every skill I build follows the same structure. The frontmatter handles identity; the body handles method:

skill-file.md
# Intellectual Thinking Partner
Version: 2.0
Created: 2026-02-11
Last Updated: 2026-02-16
Option Used: A + B (own method + best practices)
Client Origin: Mohios (general use)
Generalisable: Yes

The body of the SKILL.md typically includes:

  1. PurposeOne paragraph. What is this skill for? When should Claude activate it?
  2. Expert InstructionsThe core method. How to actually do the thing well. Built from your own expertise or extracted from a trusted source.
  3. PhasesHow the skill operates step by step. Usually: gather context, execute, refine.
  4. Output FormatWhat the result should look like. Length, structure, style constraints.
  5. 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:

Thinking
sparring-partner.md

Two modes: exploration (build on ideas) and sparring (challenge assumptions, stress-test logic).

+
Purpose: Dual-mode intellectual partner
Expert Instructions: Mode detection, questioning depth, energy matching
Phases: Detect mode → Engage → Push back or build → Synthesise
Output: Direct responses, no hedging, Socratic when needed
Quality Rules: Never agree to be agreeable, match the user's energy
Version History: v2.0, Feb 2026
Thinking
first-principles.md

Guided decomposition: surface assumptions, break to fundamentals, rebuild from truth.

+
Purpose: Socratic first-principles coach
Expert Instructions: Assumption surfacing, decomposition method
Phases: State problem → Surface assumptions → Decompose → Rebuild → Reality-check
Output: Questions, not answers
Quality Rules: Never skip the decomposition step
Version History: v1.3, Mar 2026
Production
linkedin-writer.md

Full content engine: audience psychology, five post types, three variants per draft.

+
Purpose: LinkedIn post writer with voice consistency
Expert Instructions: Audience psychology, post archetypes, formatting rules
Phases: Brief → Draft 3 variants → Component buffet → Refine
Output: Three complete posts + remix components
Quality Rules: No corporate speak, match profile voice exactly
Version History: v3.1, Mar 2026
Production
copywriting-fundamentals.md

Shared rules for tone, archetypes, and platform mechanics across all writing.

System
icp-signal-extractor.md

Run on interview transcripts. Extracts company profile, team signals, ICP fit.

+
Purpose: Extract ICP signals from interview transcripts
Expert Instructions: Signal taxonomy, fit scoring model
Phases: Ingest transcript → Extract signals → Score fit → Flag gaps
Output: Structured signal report with confidence scores
Quality Rules: Use verbatim quotes, never infer what wasn't said
Version History: v1.0, Feb 2026
System
pain-language-miner.md

Pulls verbatim customer quotes by theme and persona. The exact words matter.

System
hypothesis-generator.md

Creates testable GTM statements with confidence scores and kill criteria.

System
truth-updater.md

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

1
Meta-Prompting
The method for creating expert instructions
2
Claude Projects
The persistent workspace with Soul & Context
3
SkillsYou are here
Reusable tools built from the method
4
Knowledge Base
All of it applied to a client's business
Your expertiseSystems that sound like you
Series: 3 of 4
Meta-Prompting 101Claude ProjectsSkillsKnowledge Base
Danny Holtschke
Danny Holtschke

Danny builds AI systems for NZ businesses. He uses Claude Skills daily for consulting, content creation, and client operations. Based in Auckland.

LinkedInmohios.com

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 \u2192