Claude Code Skills, what actually matters and what's just noise

TLDR

A Claude Code Skill is a folder with a SKILL.md file in it that tells Claude how to run a specific procedure. The marketplaces are full of them. Most aren't worth installing. The ones that earn their place encode work you'd otherwise type by hand every time, and the best stack pairs your custom Skills with a few off the shelf ones plus an MCP server or two for data.

  • About 30 Skills installed at the agency. Twelve we touch every day.
  • Custom Skills do most of the lifting. Off the shelf Skills fill the gaps.
  • Skill marketplaces worth browsing, SkillsMP, the official Anthropic skills repo, and Claude Marketplaces.
  • Pair Skills with MCP servers (like Pocket's) so the procedure has data to work on.

Disclosure. We're direct affiliates for Pocket. The Pocket links on this page route through our affiliate. The marketplace links and external resource links are not affiliate links. The ranking and the recommendations don't change either way.

There's a lot of junk commentary floating around Claude Code Skills right now. Marketplaces hawking 1.2 million skills. Tutorials that explain the YAML syntax without ever telling you which Skills are worth installing. Twitter threads where every folder gets called a productivity revolution. We run Claude Code every day at Market Correct. We've built our own Skills, installed plenty more, and deleted most of them. This post is the working version of what we wish someone had handed us when we started.

What Claude Code Skills actually are. How to use them. The ones that earn their place in a daily stack. The ones that don't. Where to find good ones. And how we build our own when nothing off the shelf fits.

Spoiler. The right number of Skills is smaller than you think.

What Claude Code Skills actually are

A Claude Code Skill is a folder with a SKILL.md file in it. The Markdown describes a procedure. Optionally, there are reference files (more Markdown), scripts (Python or shell), and templates the procedure can pull in. Claude reads the SKILL.md when a request matches the skill's trigger conditions and executes whatever the file tells it to do.

That's it. There's no compiled binary, no proprietary format, no platform lock-in. A Skill is a folder. The folder lives in ~/.claude/skills/ for global use or in a project's .claude/skills/ for project-specific use. Claude Code finds them on its own.

The reason this matters is the indirection. Without Skills, every workflow lives in your head. You open Claude Code, you remember to tell it the rules, you remember the steps, you remember the constraints. With a Skill, those rules live in a file you wrote once. The next time you say "humanize this draft," Claude reads the SKILL.md, applies the rules, and produces output that matches your standards without you re-explaining them. The file is the procedure. The procedure is the asset.

The official docs sit at code.claude.com/docs/en/skills. The official Anthropic Skills repo is on GitHub at github.com/anthropics/skills. Both are worth reading once before you go shopping.

How to use Skills in Claude Code

The mental model is simple. Skills can be triggered three ways.

  1. Automatically. Claude detects that a request matches a Skill's description and reaches for it on its own. This is the path you'll use most.
  2. Manually. You type the Skill's name into the chat. "Use the em-dash-bouncer skill on this file." Useful when you want to force a specific Skill instead of waiting for the trigger to fire.
  3. Programmatically. One Skill loads another as part of its procedure. This is how composite Skills work, and it's where the lift is biggest.

To install a Skill, drop the folder into ~/.claude/skills/your-skill-name/ and make sure there's a SKILL.md inside. Claude Code picks it up on the next session start. To verify it's loaded, run /skills in Claude Code or look at the system reminder that lists available skills. No restart, no install command, no package manager needed.

Triggering one is the same flow. If your Skill's description says "use when reviewing files for em dashes," Claude will reach for it any time you ask to clean up punctuation. You don't have to remember the Skill exists. That's the part that wins. The Skills that don't trigger reliably are almost always the ones with vague or overlapping descriptions, and the fix is to tighten the description, not to add more Skills.

The Skills we use every day

Here's the actual roster, not the aspirational one. About 30 Skills installed across the agency. Twelve we touch every day. The rest sit there for the once a month case.

Custom Skills we built

mrktcorrect-blog-scaffold

Generates the HTML skeleton in one command

Outputs a new blog HTML file with the full head block, schema, design tokens, GTM, OG tags, FAQ structure, and affiliate components already wired up. The setup work that used to take 30 minutes is now a single command. Frees us up to spend the time on the writing instead of the boilerplate.

mrktcorrect-blog-finisher

The pre-publish quality gate

Runs 40+ checks across schema, FAQ, accessibility, affiliate links, banned punctuation, and AI patterns. Fails until everything passes. The "should this go live?" question gets answered by a Skill instead of by me staring at a checklist for 20 minutes.

Off-the-shelf Skills we keep installed

Not every Skill we run is custom. The ones we kept off the shelf are the ones that filled a real gap and produced output we acted on. The list is shorter than people expect.

  • ai-seo, seo-geo, seo-audit. Three SEO Skills we reach for during keyword research and audits. We've trimmed them down. The ones we kept are the ones that produced findings we acted on.
  • brand-identity. For new client brand work and guideline drafting. A solid frame for conversations that would otherwise sprawl.
  • social-media-designer. For LinkedIn carousels and stat cards. Strong opinions on what works on each platform built into the file.
  • typeset. For typography passes when something feels off but we can't articulate why. Picks up the issues we'd miss.
  • ui-ux-pro-max. For design conversations where we need a structured frame instead of vibes. Big enough that we don't load it on every task, small enough to pull when the work calls for it.
  • legal-advisor. Once a quarter for contract reviews and privacy policy updates. Doesn't replace counsel. Does flag the obvious gaps before counsel sees the draft.

Skills we installed and deleted

The marketplace is full of "agent" Skills that are mostly persona prompts. "Act like a senior developer." "Behave like a product manager." Most of them don't do anything a one-line system prompt couldn't do. We deleted those. Skills that wrap other tools (CLI commands, formatters, linters) without adding judgment, we kept the actual tools and deleted the wrappers. Skills that were 80% repeating standard advice we'd already absorbed, gone. They aren't useful and they crowd the description list, which makes Claude worse at picking the right Skill when it matters.

The principle is harsh but fair. A Skill that doesn't change what you'd do is fluff. A Skill that captures a procedure too complex to keep in your head every time is gold.

The point of a Skill isn't to make Claude smarter. It's to keep your standards in a file so you stop re-explaining them. The win compounds the longer you run the file.

Skills with other Skills baked in

The richest pattern in this stack is composition. The market-correct skill loads reference files (brand-context.md, design-system.md, blog-redesign-runbook.md). When a task fits one of those, the parent Skill points to it. That's the basic version. The richer version is one Skill loading another Skill loading another Skill.

Our blog production runs as a chain. market-correct-blog kicks off, loads market-correct for brand context, loads new-humanizer for voice, loads em-dash-bouncer for punctuation, then loads mrktcorrect-blog-finisher for the quality gate. One Skill kicks off five. The blog post that takes 90 minutes manually takes 15 with the pipeline running, and the output is more consistent than anything we'd produce by hand.

The trick is keeping the parent Skill's SKILL.md short. Long parents drown the index and confuse the trigger logic. The version we run says, in essence, "for blog posts, load these other Skills in this order, and follow their instructions." Most of the actual content lives in the leaf Skills. The parent is glue.

That's the difference between a useful composite Skill and a bloated one. The bloated version tries to do everything itself and overlaps with leaf Skills. The useful version is a manifest, not a manual. If you're considering building a parent Skill that has more than 100 lines of instructions, stop and ask whether half the content belongs in a child Skill it loads instead.

What's needed and what's fluff

Three filters before installing any Skill.

  1. Does it encode a procedure I'd otherwise type by hand every time? If yes, install. If no, don't. The Skills that earn their place are the ones that capture work you keep redoing.
  2. Is the SKILL.md short enough to scan in a minute? If yes, the author respects your context window. If no, it's bloat dressed up as completeness.
  3. Does it produce a different output than I'd produce without it? If yes, the rules in the file are doing real work. If no, you have a placebo.

The fluffiest Skills wrap a one-line prompt around an existing capability and call it a "framework." The best Skills do something specific and stop. em-dash-bouncer is one regex and a fail condition. That's why it's the Skill I trust most. market-correct-blog is glue plus five well-tested children. That's why it ships our content.

Avoid Skill packs that bundle 50 capabilities without any selection. Find the three that matter. Keep them. Delete the rest. The cost of a bloated Skill folder isn't disk space. It's the noise it adds to Claude's decision about which Skill to reach for, and the noise gets worse with every Skill you add.

Where to find good Claude Code Skills

The marketplace situation has matured fast in 2026. A few places worth bookmarking.

  • SkillsMP has the broadest catalog. Claims roughly 1.2 million agent skills, though most are duplicates and template prompts. Strong filtering by occupation, author, and popularity. Worth a browse, with the caveat that you should read every SKILL.md before you install it.
  • github.com/anthropics/skills is the official Anthropic repo. Smaller catalog, higher signal. The skill-creator and skill-creator-update Skills here are useful starting points if you want to build your own.
  • Claude Marketplaces is a directory of directories. Catalogs Skills, MCP servers, and plugins so you can compare what's out there without bouncing between five different sites.
  • Claude Skills Market at skills.pawgrammer.com hosts a community-curated collection of around 280 Skills focused on practical workflows. Less commercial than SkillsMP, more opinionated about what's worth shipping.
  • LobeHub aggregates Skills, agents, and prompts together, which is useful if you want one search across the whole agent ecosystem instead of just Skills.
  • github.com/daymade/claude-code-skills and github.com/mhattingpete/claude-skills-marketplace are two solo-maintained Skill repos that lean toward software engineering workflows. Higher signal than most of the marketplace listings because they're curated by humans who use the Skills themselves.

The same caution applies everywhere. Treat marketplace Skills like any other code you install. Read the SKILL.md before you drop it in. Check what scripts it includes, what files it touches, what external services it calls. The marketplaces filter for low-quality repos but they don't audit for malicious code, and a Skill can run shell commands and read files just like any process you start on your machine. The good news, Skills are plain text. Five minutes of reading tells you what one does.

How we build our own Skills

When nothing off the shelf fits, we build. The process is short.

  1. Identify a procedure we run more than once. If we run it weekly and it has steps, it's a Skill candidate. If we run it daily and we keep forgetting steps, it's a Skill priority.
  2. Write the SKILL.md by hand on the first try. Plain Markdown, with a name, a description, and the steps. Don't optimize. Make it work end to end before you make it pretty.
  3. Use it for two weeks. Note where it failed, where we had to override it, where it produced output we re-edited. Those are the fix points.
  4. Iterate the SKILL.md to handle the failures. Move generic content into reference files the Skill loads on demand, so the SKILL.md stays scannable.
  5. Once the Skill is producing output we ship without edits, lock it down. Move on to the next procedure. A Skill that's "good enough" today is more valuable than one you keep tinkering with for another month.

The failure mode is over-engineering early. Don't write a 400-line SKILL.md on day one. Write 40 lines, run them, and let the real failures tell you what to add. Half the Skills we keep started as ten-line files that we extended over the first two weeks of use. A few stayed at ten lines because that was enough.

The other failure mode is description drift. The trigger conditions in the description field decide whether Claude reaches for the Skill on the right tasks. Vague descriptions get ignored. Overlapping descriptions get pulled in for tasks they shouldn't run on. Tighten the language. Include the words a user would actually say. Drop the marketing copy and write what the Skill is for in one sentence.

Pairing Skills with MCP and the Pocket workflow

The reason Skills matter as part of a working stack, not just a productivity novelty, is what they let you compose. Skills handle procedures. MCP servers handle data and external system access. Claude Code orchestrates both. A Skill says "when the user asks about a meeting, look up the transcript." An MCP server is what actually fetches the transcript. Different jobs, complementary tools, and the combined output is where the value compounds.

Pocket is the AI voice recorder we run for off-laptop meetings. It captures audio, writes summaries, and ships an MCP server that lets Claude Code read across the captures without opening Pocket's app. Pocket also lets you pick the AI model that writes the summaries, and we run ours on Claude Opus 4.7. So when we ask Claude Code "what did the client say about budget on the Tuesday call?" the question routes through our Skill stack (which knows our voice and our client context) and pulls answers from the Pocket MCP server (which has the actual transcripts). Skills give Claude the procedure. MCP gives Claude the data. The combined output is what makes the workflow stick.

If you're already running Claude Code and you want the off-laptop capture half of the same workflow, Pocket is where to start. We've broken the head-to-head with Plaud down separately in our Pocket vs Plaud post, and the longer story of how Pocket fits into our day in our Granola and Pocket review. Most of the other AI recorders don't expose an MCP server, which is the bottleneck for any Skill-driven retrieval. It's the same reason we run Granola for desktop calls instead of the alternatives. The MCP server is the part that lets the rest of the stack reach the data.

The off-laptop half of our Claude Code stack. Pocket runs on Claude Opus 4.7, exposes an MCP server, and writes summaries you can search from a Skill.

Get Pocket

The bottom line

Bottom line

Claude Code Skills are folders with SKILL.md files in them. The right number is smaller than the marketplace suggests. The Skills that earn their place are the ones that capture procedures you'd otherwise type by hand, and the ones that compose into pipelines that run end to end without manual intervention.

The lift comes from your custom Skills, not the marketplace ones. Build a few that match how you actually work. Install a few off-the-shelf that fill gaps. Delete the rest. If you run a stack that pairs Skills with MCP servers, that's where the value compounds, because Skills handle the rules and MCP handles the data.

For our stack. Pocket for off-laptop capture (runs on Opus, exposes an MCP server), Granola for desktop calls, Claude Code on top of both with the Skill stack above. If you want help building a paid program with the same operational discipline, talk to us.

Tools and Workflow

Want to see what an AI-native agency actually runs on?

We use Claude Code, Pocket, and Granola as the spine of how we run client work. If you want a paid program built and operated with the same discipline, talk to us.

Talk to us about your campaigns
FAQ

Questions about Claude Code Skills

A Claude Code Skill is a folder with a SKILL.md file inside it. The Markdown file describes a procedure Claude should follow when a request matches the skill's trigger conditions. Skills can include reference files, scripts, and templates the procedure pulls in. There's no compiled binary, no proprietary format, no platform lock-in. The folder lives in ~/.claude/skills/ for global use or in a project's .claude/skills/ directory for project-specific use. Claude Code finds them on its own and triggers them automatically when the request matches.

Drop the Skill folder into ~/.claude/skills/your-skill-name/ and make sure there's a SKILL.md file inside. Claude Code picks it up on the next session start. To verify it's loaded, run /skills in Claude Code or check the system reminder that lists available skills. For project-level Skills, use .claude/skills/ inside your project directory instead. No restart, no install command, no package manager needed.

Three ways. First, automatically. If the Skill's description matches what you're asking for, Claude reaches for it on its own. Second, manually. Type the Skill name into the chat, like 'use the em-dash-bouncer skill on this file.' Third, programmatically. One Skill can load another, which is how composite Skills work. The first method is the one you'll use most. The trigger conditions in the SKILL.md description are what make this work, so write them carefully when you build your own.

Skills handle procedures. MCP servers handle data and external system access. A Skill is instructions for what Claude should do. An MCP server is a connection to a tool or data source Claude can read from or write to. We pair them constantly. The Skill says 'when the user asks about a meeting, look up the transcript,' and the MCP server is what actually fetches the transcript from Pocket or Granola. Different jobs, complementary tools. You can run Skills without MCP servers and the other way around, but the combined stack is where the value compounds.

Skills are part of Claude Code itself, which works with any Claude account that has API access or a Claude Pro plan. There's no separate skill subscription, no marketplace fee, no licensing layer. The Skills you build or install are just files in a folder. The cost question is the underlying Claude usage. If you're running a heavy Skill stack with long context, the API token spend will move. If you're running on a Pro plan, the message-cap rules apply. Either way, the Skills don't add a separate cost.

Several marketplaces and repos. SkillsMP at skillsmp.com has the broadest catalog with strong filtering. The official Anthropic skills repo lives at github.com/anthropics/skills. Claude Marketplaces at claudemarketplaces.com is a directory of directories. skills.pawgrammer.com hosts a community-curated collection. LobeHub and a handful of solo-maintained GitHub repos round out the rest. The official Anthropic docs at code.claude.com/docs/en/skills are worth reading first so you know what you're looking at before you start installing things.

Yes, and you should. The format is plain Markdown with optional reference files. Write the SKILL.md by hand on the first try with a name, a description, and the steps. Drop it into ~/.claude/skills/your-skill-name/SKILL.md. Use it for two weeks, note where it failed, and iterate. The skill-creator skill in the Anthropic repo is a useful starting point. Most of the Skills we run at the agency are ones we built ourselves to encode procedures we'd otherwise type by hand every time.

Three filters. First, does it encode a procedure I'd otherwise type by hand every time? Second, is the SKILL.md short enough to scan in a minute? Third, does it produce a different output than I'd produce without it? If yes to all three, install. If no to any, skip. The fluffiest Skills wrap a one-line prompt around an existing capability and call it a framework. The best Skills do something specific and stop. Em dash detection is one regex. That's the kind of thing worth keeping installed.

The SKILL.md file is the instruction sheet. It contains a name, a description, trigger conditions, and the actual steps Claude should execute. When a request matches the description, Claude reads the file and follows what's written. The file can reference other files (scripts, reference docs, templates) the procedure should pull in. The whole format is Markdown plus optional YAML frontmatter, which means anyone can read, audit, and modify a Skill without special tooling.

Yes, and this is where the value compounds. A composite Skill is one that calls other Skills as part of its procedure. We run a blog production Skill that, when triggered, loads our brand context Skill, then our humanizer Skill, then our em dash bouncer Skill, then our pre-publish quality gate. One command, full pipeline. The trick is keeping the parent Skill short. Long parents drown the index. The version we run is essentially a manifest, not a manual. Most of the actual content lives in the leaf Skills.

Common causes. The Skill folder isn't in the right location (it has to be in ~/.claude/skills/ or .claude/skills/ inside your project, not somewhere else). The SKILL.md filename is wrong (it's case-sensitive on most systems). The frontmatter is malformed (a missing name or description field will hide the Skill). Claude Code wasn't restarted after the Skill was added. Run /skills in Claude Code to see the loaded list. If your Skill isn't there, it's a path or syntax issue, not a Claude bug.

A slash command is a one-shot prompt template you trigger by typing /command-name. A Skill is a procedure with optional reference files and trigger conditions that Claude reaches for automatically. The two overlap at the edges. A simple Skill that does one thing on demand looks a lot like a slash command. The difference shows up on complex work. Skills support multi-step procedures, file references, conditional branches, and other Skills loading inside them. Slash commands don't. Use slash commands for snippets. Use Skills for workflows.

Treat them like any other code you install. Read the SKILL.md before you drop it in. Check what scripts it includes, what files it touches, what external services it calls. The marketplaces filter for low-quality repos but they don't audit for malicious code, and a Skill can run shell commands and read files just like any process you start on your machine. The good news is Skills are plain text. Five minutes of reading tells you what it does. Don't install Skills you haven't read, especially ones with bash scripts or Python files inside.

About 30 installed across the agency machine. Twelve we touch every day. The rest sit there for the once a month case. The right number is smaller than the marketplace suggests. Most of the daily Skills are ones we built. The off the shelf Skills we keep installed are the ones that filled a real gap. The ones we deleted are persona prompts that didn't change what Claude would do anyway, and bloated frameworks that ran 400 lines to say what 40 would have covered.

Most of the time, yes. The trigger conditions in each Skill's description are what Claude matches against. A well-written description (specific, focused, non-overlapping with other Skills) gets picked up reliably. A vague description gets ignored or, worse, gets pulled in for tasks it shouldn't run on. If Claude isn't picking the Skill you expect, the description is the first place to look. Tighten the trigger language. Include the words a user would actually say. Drop the marketing copy and write what the Skill is for in one sentence.