Claude Code Skills: How to Build Reusable AI Workflows That Run Your Business
📢
← Back to Blog

Claude Code Skills: How to Build Reusable AI Workflows That Run Your Business

John Aspinall · · 13 min read

Every operator I talk to has the same complaint about AI coding agents: they keep re-explaining the same task every session. Write the morning brief. Generate the client report. Audit the landing page. Review the PR with our specific checklist. Every time, they type out the same multi-paragraph prompt, tweak the same instructions, and hope Claude remembers the format they want. Claude Code skills fix this completely. You write the instructions once, save them as a markdown file, and invoke them with a slash command for as long as you run that business.

I run about thirty Claude Code skills across four ventures right now. They handle everything from my daily operations briefing to blog post generation to competitive pricing analysis. Each one took me fifteen minutes to build. Most of them have been running unchanged for months. The compound effect is significant — I estimate skills save me about twelve hours a week of re-prompting alone, not counting the consistency gains from having every output follow the same structure.

This post is the guide I wish I had when I started. No theory, no hand-waving about "the future of AI workflows." Just the exact steps to build Claude Code skills that automate your actual business operations.

What Are Claude Code Skills?

Claude Code skills are reusable instruction sets stored as markdown files that you invoke with a slash command. Think of them as executable SOPs — standard operating procedures that Claude follows exactly, every time, without you re-typing the instructions.

When you type /morning-brief in Claude Code, it loads your morning-brief skill file, reads every instruction you wrote, and executes the workflow. The skill can include specific steps, output formats, tool calls, quality checks, and decision logic. It is deterministic in structure but intelligent in execution — Claude still reasons about your data, it just does it within the guardrails you defined.

Skills replaced three things in my operation: copy-pasted prompt templates, verbal instructions to team members, and the twenty minutes I used to spend at the start of every Claude session re-establishing context.

How Claude Code Skills Work: Anatomy of a Skill File

A skill is a markdown file in your project's .claude/skills/ directory or your personal ~/.claude/skills/ directory. The file contains frontmatter metadata and a body of instructions. Here is the skeleton:

---
description: "Generate a weekly client performance report"
user-invocable: true
---

# Weekly Client Report

## Context
You are generating a weekly performance report for an ecommerce client.
Read the latest data from the analytics dashboard and format it per the
template below.

## Steps
1. Pull the last 7 days of revenue, sessions, and conversion rate
2. Compare against the prior 7-day period
3. Flag any metric that moved more than 10% in either direction
4. Write a 3-paragraph executive summary
5. List the top 3 recommended actions

## Output Format
- Subject line: "[Client Name] Weekly Performance — [Date Range]"
- Sections: Summary, Key Metrics Table, Recommendations, Next Steps
- Tone: Direct, data-first, no filler

The description field tells Claude when this skill is relevant — it can auto-suggest it in context. The user-invocable: true flag means you can call it with a slash command. The body is your workflow, written in plain English.

Two rules that took me weeks to learn: keep each skill to one job, and write instructions as if you are briefing a competent contractor who has never worked with you before. Ambiguity in a skill file produces the same inconsistency you were trying to eliminate.

Your First Business Skill: A Daily Operations Briefing

Let me walk through building a real skill from scratch. This is a simplified version of the morning brief I run every day across my ventures.

Step 1: Create the file.

mkdir -p .claude/skills
touch .claude/skills/morning-brief.md

Step 2: Write the skill.

---
description: "Generate a daily operations briefing covering revenue, tasks, and priorities"
user-invocable: true
---

# Daily Operations Brief

Generate my morning briefing for today. Follow these steps exactly.

## Data Collection
1. Read my Todoist inbox and list any tasks due today or overdue
2. Check for any unread Fathom meeting summaries from yesterday
3. Review any open pull requests that need my attention

## Analysis
- Identify the single highest-priority item across all ventures
- Flag anything that is blocked or at risk of missing a deadline
- Note any decisions I need to make today

## Output
Format as a single briefing document:

**Top Priority:** [one sentence]

**Today's Decisions:**
- [decision needed] — [context in one line]

**Task List** (ordered by priority):
1. [task] — [source: todoist/meeting/pr]

**Yesterday's Completions:**
- [what got done]

Keep the entire briefing under 500 words. No pleasantries, no filler.
End with: "Briefing complete. [count] items need attention."

Step 3: Run it.

Open Claude Code in your project directory and type /morning-brief. Claude loads the skill, executes each step against your connected tools (Todoist, Fathom, GitHub via MCP), and delivers a structured briefing in under sixty seconds.

Step 4: Iterate.

After three days of running the skill, you will know exactly what to fix. Maybe you want revenue numbers added. Maybe the task list needs a time estimate column. Edit the markdown file, save it, and the next invocation reflects your changes immediately. No deploys, no builds, no configuration UI — just a text file you control.

Seven Claude Code Skills Running My Business Right Now

Here are real skills I use daily or weekly, with what each one actually does:

1. /blog-post — Reads existing posts, picks a topic from my content calendar, does keyword research, writes a 2,000+ word post in my voice, saves it to the correct directory, and commits it. This post was generated by a version of this skill.

2. /client-audit — Takes an Amazon ASIN as input, pulls the listing data, scores the images against my rubric, evaluates the A+ content, and generates a prioritized fix list with estimated revenue impact.

3. /competitor-scan — Monitors a set of competitor ASINs for price changes, new reviews, and listing updates. Outputs a diff against last week's scan.

4. /pr-review — Reviews a pull request against my specific code quality checklist: no hardcoded secrets, proper error handling, test coverage for new functions, and clean commit messages. Posts the review as GitHub comments.

5. /meeting-debrief — After a client call, pulls the Fathom transcript, extracts action items, creates Todoist tasks for each one, and drafts a follow-up email.

6. /pricing-calc — Takes product cost, target margin, and shipping weight as inputs, then calculates my pricing across three scenarios (aggressive, moderate, premium) with break-even units for each.

7. /weekly-review — Every Sunday, compiles the week's completed tasks, revenue changes, content published, and agent performance metrics into a one-page review I scan in five minutes.

Each of these skills is a single markdown file between 40 and 150 lines. None of them required writing code. The total development time across all seven was about two hours. They have collectively run hundreds of times.

Organizing Your Claude Code Skill Library

Once you have more than five skills, organization matters. Here is the structure I use:

.claude/
  skills/
    ops/
      morning-brief.md
      weekly-review.md
    content/
      blog-post.md
      social-repurpose.md
    amazon/
      client-audit.md
      competitor-scan.md
      pricing-calc.md
    dev/
      pr-review.md
      deploy-check.md

Three principles that keep this clean:

Group by business function, not by frequency. You will add skills faster than you expect. Organizing by "daily" vs "weekly" falls apart within a month. Organizing by function (ops, content, amazon, dev) scales indefinitely.

Name skills for what they produce, not what they do. /morning-brief beats /generate-daily-summary-from-multiple-sources. You type these names every day. Keep them short.

One skill, one job. If a skill file exceeds 200 lines, it is trying to do two things. Split it. A /meeting-debrief that also does follow-up scheduling should become /meeting-debrief and /meeting-followup. Atomic skills compose better than monolithic ones.

Personal skills that span all your projects go in ~/.claude/skills/. Project-specific skills go in the repo's .claude/skills/. Claude Code merges both at runtime, so you can have a personal /morning-brief that works everywhere and a project-specific /deploy-check that only appears in that repo.

Advanced Patterns: Variables, Chaining, and Composition

Once the basics click, three patterns unlock the real power of Claude Code skills for business operators.

Pattern 1: Parameterized Skills

Skills can accept arguments. Instead of hardcoding a client name, pass it at invocation:

/client-audit ASIN=B0EXAMPLE123 client="Acme Supplements"

Your skill file references these as variables that Claude substitutes at runtime. This turns one skill into a reusable template across dozens of clients.

Pattern 2: Skill Chaining

Invoke one skill from within another. My /weekly-review skill includes an instruction to run /competitor-scan first and incorporate its output. The weekly review does not need to know how competitor scanning works — it just calls the skill and uses the result.

This is the same principle as function composition in code. Each skill has a single responsibility. Complex workflows emerge from chaining simple skills together.

Pattern 3: Scheduled Skills via Routines

Claude Code Routines let you run skills on a cron schedule without opening a terminal. My /morning-brief fires at 6:30 AM every weekday. My /competitor-scan runs every Monday at midnight. I configured these once and have not touched them since.

The combination of skills and routines is where the real leverage sits. You build the skill (the what), attach it to a routine (the when), and the system runs your business operations while you sleep. I have seven routines running right now. They generate about forty outputs per week that I review in batch, usually over coffee.

Common Mistakes That Kill Your Claude Code Skills

I have built probably fifty skills at this point. About fifteen of them failed before I fixed the underlying pattern. Here are the mistakes I see every operator make:

Writing skills that are too vague. "Analyze the data and give me insights" is not a skill — it is a wish. Skills need specific steps, specific outputs, and specific quality criteria. If you would not hand these instructions to a new hire and expect correct output on day one, they are not ready for a skill file.

Stuffing too much context into the skill. A skill file is instructions, not a knowledge base. If your skill needs to know your brand guidelines, pricing rules, and competitive landscape, put those in your CLAUDE.md or a reference file that the skill reads — do not inline them. Skills should be lean instructions that point to rich context stored elsewhere.

Never iterating after the first version. Your first skill draft will be 70% right. Run it five times, note what is off, and edit the markdown file. This iteration cycle is where skills go from "sometimes useful" to "I could not run my business without this." Budget fifteen minutes to refine after the first week of use.

Skipping the output format section. Without explicit formatting instructions, Claude will vary its output structure every time. Specify the exact sections, the exact order, whether you want bullet points or paragraphs, and any length constraints. The whole point of a skill is consistency.

Building skills you only need once. If you will run a workflow fewer than five times, just type the prompt directly. Skills have a setup cost — a small one, but real. Reserve them for workflows you repeat weekly or more.

FAQ

How long does it take to build a Claude Code skill?

Most business skills take ten to twenty minutes to write from scratch. The markdown file is typically 40-150 lines. The real investment is the iteration cycle — plan to spend another fifteen to thirty minutes refining after the first week of use. After that, maintenance is negligible. I have skills that have been running unchanged for three months.

Do Claude Code skills work with MCP servers and external tools?

Yes. Skills can reference any tool that Claude Code has access to through MCP — Todoist, Fathom, GitHub, Slack, Google Sheets, databases, APIs. If Claude can reach it in a normal session, it can reach it inside a skill. This is what makes skills powerful for business operations: they orchestrate across your entire tool stack, not just code files.

Can I share skills across projects and with a team?

Personal skills in ~/.claude/skills/ are available in every project you open. Project skills in .claude/skills/ are committed to the repo and shared with anyone who clones it. For team-wide standardization, commit your skills to a shared repo, and every team member gets the same workflows. This is how I ensure every client audit follows the same rubric across my agency.

What is the difference between a Claude Code skill and a CLAUDE.md file?

CLAUDE.md is persistent context — it loads automatically at the start of every session and tells Claude about your project, conventions, and preferences. A skill is an on-demand workflow — it loads only when you invoke it and tells Claude what to do right now. They complement each other: CLAUDE.md provides the background knowledge, skills provide the action plan. Think of CLAUDE.md as the employee handbook and skills as the task-specific checklist.

Can I schedule Claude Code skills to run automatically?

Yes, through Claude Code Routines. You create a routine with a cron expression and a prompt that invokes your skill. The routine fires on schedule, runs the skill, and delivers the output — all without you opening a terminal. I run seven scheduled skills that handle daily briefings, weekly reviews, competitor monitoring, and automated blog publishing.

Build Your First Skill This Week

Claude Code skills are the single highest-leverage feature most operators ignore. They turn your hard-won operational knowledge — the prompts you have refined, the workflows you have perfected, the output formats your clients expect — into executable, repeatable, compounding assets.

Here are your three actions:

  1. Pick your most-repeated prompt. Whatever you type into Claude most often — the daily check-in, the report template, the review checklist — that is your first skill. Write it as a markdown file in .claude/skills/, run it five times, and iterate.

  2. Build a skill library with three to five skills this month. One for daily ops, one for your primary revenue activity, one for content or communication. Organize them by function from the start. You will thank yourself at skill number fifteen.

  3. Attach your most valuable skill to a Routine. Pick the one workflow that would benefit most from running automatically — the morning brief, the competitor scan, the weekly review — and schedule it. That is the moment Claude Code stops being a tool you use and starts being a system that runs your business.

The operators who compound fastest are not the ones who write better prompts. They are the ones who write the prompt once, save it as a Claude Code skill, and never type it again.

Put AI to work inside the business you already run.

The Operator Intelligence: Multi-Agent OS is a 4-week live build: second brain, Claude Code workflows, Codex execution — on your real business. The next cohort is forming now.

Get first access →

Not ready? Get the free newsletter — the AI workflows I actually ship, when they're worth your inbox.