Justin McKelvey

Justin McKelvey

Fractional CTO · 15 years, 50+ products shipped

AI for Business 7 min read

How to Use Claude Skills: The 20-Minute Setup That Stops You Re-Explaining Your Business (2026)

Quick Answer

How to use Claude Skills: make a folder, put a SKILL.md in it with a description of when to use it and the instructions to follow, and save it where Claude looks — ~/.claude/skills/ for everything you do, .claude/skills/ for one project, or enable it on your claude.ai account for Cowork. Claude loads it automatically when your request matches the description, or you type /skill-name. Twenty minutes, no code. The hard part is not the file. It's deciding which three procedures you're sick of re-explaining.

Verified September 2026 · Author: Justin McKelvey, fractional CTO & AI consultant, 15 years in software, 50+ products shipped

TL;DR: A Skill Is the Checklist You Keep Pasting Into Chat

Most of the "Claude Skills" content out there is written for developers building agent frameworks, and it makes a folder with one markdown file sound like infrastructure. It isn't. Anthropic's own docs describe the trigger plainly: create a skill when you keep pasting the same instructions or multi-step procedure into chat, or when a section of your always-on context has grown into a procedure rather than a fact. That's it. A Skill is a saved procedure with a routing rule on top. I run both of my businesses on a handful of them, and the ones that earn their keep are embarrassingly ordinary — how we write a proposal, how we triage an inbound lead, how we prep a Monday report. As of September 2026 they work the same way in Claude Code, the Claude.ai app, Cowork, and the API, because the format is an open standard.

What a Skill actually is (the definition, in one paragraph)

A Skill is a folder. Inside it is a file called SKILL.md with two parts: YAML frontmatter between --- markers, whose description tells Claude when to use the skill, and markdown content underneath, which is what Claude follows when it does. The folder can also hold supporting files — scripts, templates, reference documents — that load on demand. Claude reads only each skill's name and description up front; the full body loads when a task matches. So a 40-page reference document inside a skill costs you nothing until the moment it's needed. That's the difference between a Skill and stuffing everything into always-on context: Skills are lazy, in the good sense. (The Cowork-specific catalog — the 15 built-in skills and building custom ones inside Cowork — is its own post: Claude Cowork Skills explained. This one is the cross-surface mechanics.)

Step 1: Write the SKILL.md (10 minutes)

Here's the shape, using the first skill I'd tell any owner to build — the one that drafts replies to inbound leads in your voice, from your real facts:

---
description: Drafts a reply to an inbound lead or customer email in our voice. Use when the user pastes an email and asks for a reply, a draft, or "what should I say."
---

## How we reply
- Answer the actual question in the first two sentences.
- Quote prices only from business-facts.md in this folder. Never invent a number.
- One call to action, never two. If they already declined a call, no CTA.
- Sign off "Justin" — no "best regards."

## Before you draft
Read business-facts.md for current offers and policies.

Two things to notice. The description is written like a routing rule — specific enough that Claude activates it at exactly the right moment and not when you ask something unrelated. And the instructions point at a supporting file (business-facts.md) instead of repeating the facts, so the facts live in one place and the skill stays short. That two-file pattern — a lean SKILL.md plus a facts file — is the single most useful habit in this whole post.

Step 2: Put it where Claude looks (2 minutes)

Where a skill lives decides who can use it. In Claude Code, as of 2026:

  • Personal~/.claude/skills/<skill-name>/SKILL.md. Available in every project you open. Start here.
  • Project.claude/skills/<skill-name>/SKILL.md inside a repository. Only that project sees it, and it travels with the repo when a teammate clones it.
  • Plugin — bundled inside an installed plugin, namespaced as plugin-name:skill-name so it can't collide.
  • Enterprise — pushed through managed settings to everyone in the organization.

When two skills share a name, enterprise beats personal and personal beats project — and any of them beats a bundled skill with the same name. Claude Code watches these folders live, so editing a SKILL.md takes effect in the current session without a restart. One gotcha worth knowing: Cowork and cloud sessions don't read the folders on your machine at all. They load the skills enabled on your claude.ai account, synced at session start, which you manage from Customize in the desktop sidebar or the skills settings on claude.ai. If a skill only exists in ~/.claude/skills/, a scheduled Cowork run will report it as not found. Enable it on the account and the problem goes away.

Step 3: Invoke it — or let Claude do it (1 minute)

Two ways. Ask something that matches the description ("here's an email from a lead, what should I say back?") and Claude loads the skill on its own. Or type / followed by the skill name to run it directly. Claude Code also lets you flip a skill to manual-only in the frontmatter, so Claude never triggers it unprompted — the right setting for anything that spends real time or money, like a full audit or a batch job. And yes: the old custom commands were merged into skills, so a .claude/commands/deploy.md and a .claude/skills/deploy/SKILL.md both create /deploy and behave the same.

Using Skills in Claude.ai, not just Claude Code

The same format runs in the app. Anthropic ships its own skills there — the document, spreadsheet, presentation, and PDF ones that make Claude produce real files — and you can upload a custom skill as a zip from the skills area in Settings. As reported for 2026, custom skills are available on Pro, Max, Team, and Enterprise with code execution turned on, and Team or Enterprise admins enable them for the whole organization first. Whatever you enable on the account is what Cowork picks up. For developers, the Skills API — reported generally available in August 2026 — lets the same SKILL.md ship inside a product. One file, four surfaces. That's the reason to learn the format once.

The three skills every business owner should build first

  1. The reply skill (above). Inbound email in, draft in your voice out, prices only from your facts file. This is the one that pays daily.
  2. The intake skill. "Use when the user pastes notes from a discovery call." It turns your messy call notes into the same five-section summary every time — situation, pain, budget signal, next step, risks — so your CRM stops being a graveyard of half-typed thoughts.
  3. The Monday skill. "Use when the user asks for the weekly report." It reads the same three sources you check every Monday and produces the same one-page brief. Manual-only. Run it once a week and stop re-explaining what "the report" means.

Notice none of these are clever. That's the point — the value of a skill is repetition, not intelligence. The clever version is the one you'll never finish.

The mistakes I see in the first week

  • Description written like a title. "Proposal skill" routes nothing. "Use when the user asks for a proposal, a scope, a quote, or an SOW" routes correctly.
  • One skill that does everything. One clear job per skill. Two related jobs are two skills.
  • Facts inside the skill. Prices, policies, and names change. Put them in a supporting file the skill reads, so you update one place.
  • Skipping the account enable. Works on your laptop, fails in Cowork. See Step 2.

The micro-action for today

Open your chat history and find the instruction you've pasted most often in the last month. That's your first skill. Twenty minutes, one folder, one file. If you'd rather have the whole system installed — the skills, the facts file they read from, and the training so your team actually uses them — that's what the Claude for Small Business install is (from $4,500, about two weeks and three hours of your time). The do-it-yourself version with the templates is the CFSB Playbook ($397, 30-day money-back), and if you want to talk through which procedures are worth turning into skills before you build any, that's a free strategy call. Related reading: how to actually use Claude Code day to day and how to use Claude Projects, which is where the facts file often starts life.

Free Resource Justin McKelvey

Get the Free AI Content Toolkit

The exact system I use to turn one idea into a month of content — atomization framework, voice template, prompt library, weekly system.

Frequently Asked Questions

What are Claude Skills?
A Claude Skill is a reusable package of instructions Claude can load when a task calls for it: a folder containing a SKILL.md file (YAML frontmatter with a description, then markdown instructions), plus any supporting files — scripts, templates, reference documents. Claude reads only the name and description of each skill up front and loads the full body when it matches the task, so long reference material costs nothing until it's used. Skills follow the open Agent Skills standard and work across Claude Code, the Claude.ai app, Cowork, and the API.
How do I create a Claude Skill?
Make a folder named for the skill, put a SKILL.md inside it, and write two things: YAML frontmatter with a description that says when to use it, and markdown instructions Claude follows when it runs. In Claude Code, save it under ~/.claude/skills/<name>/ for all your projects or .claude/skills/<name>/ inside a project. That's the whole minimum — the folder name becomes the /command and the description does the routing. Add supporting files to the folder later as the skill grows.
Where do Claude Skills live?
In Claude Code there are four locations, and where a skill lives decides who can use it: enterprise (managed settings, everyone in the organization), personal (~/.claude/skills/, all your projects), project (.claude/skills/, that repository only), and plugin (inside an installed plugin). When names collide, enterprise wins over personal and personal over project. Cowork and cloud sessions don't read your machine's folder at all — they load the skills enabled on your claude.ai account, which you manage from Customize in the desktop sidebar or the skills settings on claude.ai.
How does Claude decide to use a skill?
By the description in the frontmatter. At the start of a session Claude sees the name and description of every available skill; when your request matches one, it loads that skill's full instructions. You can also invoke any skill directly by typing a slash and its name, and Claude Code lets you mark a skill as manual-only so Claude never triggers it on its own. In practice the description is the whole game — write it like a routing rule ('Use when the user asks for a client proposal, a scope, or a quote'), not like a title.
Can I use Claude Skills in Claude.ai, not just Claude Code?
Yes. In the Claude.ai app and desktop, Anthropic ships its own skills (documents, spreadsheets, presentations, PDFs) and lets you upload custom ones as a zip from the skills area in Settings; as reported for 2026, custom skills are available on Pro, Max, Team, and Enterprise with code execution enabled, and Team or Enterprise admins turn them on for the organization. Skills you enable on your account are what Cowork sessions load. The SKILL.md format is the same everywhere, which is the point of the open standard.
What is the difference between a Claude Skill, a Project, and CLAUDE.md?
Scope and timing. CLAUDE.md is always-on context for a codebase — facts Claude should know every session. A Project is a container for files and instructions around one body of work. A Skill is a procedure that loads only when a task calls for it, which is why Anthropic's own guidance is to create one when a section of CLAUDE.md has 'grown into a procedure rather than a fact,' or when you keep pasting the same checklist into chat. Facts go in CLAUDE.md or a Project; repeatable how-we-do-it goes in a Skill.

More on AI for Business

Is Qwen Free? What $0 Gets You in 2026 (and What Alibaba Quietly Ended in April)

Yes — Qwen Chat is free with no paid consumer tier at all, and the open-weights models are free to run yourself. What ended in April 2026 was the free developer API, replaced by a one-time 70-million-token trial. What free covers, what the API costs, and the data question a US business should ask first.

5 min

Is Microsoft Copilot HIPAA Compliant in 2026? Yes — Except the Part That Searches the Web

Microsoft already signed the BAA — it's in the Data Protection Addendum you accepted at purchase, and Microsoft 365 Copilot is named on the in-scope list. So the contract isn't your problem. Two other things are, and Microsoft prints one of them in a footnote.

8 min

Is Claude HIPAA Compliant in 2026? Not on the Plan You're Probably Using

No AI model is HIPAA compliant. A signed Business Associate Agreement is — and Anthropic won't sign one for Claude Pro, Max, Team, or self-serve Enterprise. Here's exactly which tiers of Claude and ChatGPT are covered, which ones aren't, and why the business plan you bought is probably the wrong one.

8 min

Claude Usage Limits in 2026: There Is No Number, and That's the Answer

Anthropic doesn't publish a message count for any Claude plan — not Free, not Pro, not Max. What it publishes are multipliers and two meters. Here's how the 5-hour window and the weekly cap actually work, what each tier is reported to get, and what to do the third time you hit the wall.

6 min
Justin McKelvey, Fractional CTO and AI consultant in Austin, TX

Written by

Justin McKelvey

Fractional CTO & AI consultant in Austin, TX. 15 years building software, 50+ products shipped, $53M+ in client revenue generated. I help $1M–$50M founders ship production software and automate operations with AI — without hiring a full-time executive team.

Work with me

If this was useful, here are two ways I can help: