KaairosGet the kit
Blog · 6 min read

The best Claude Code skills (we deleted the rest)

With skills, the best list is the shortest one. The categories that survive real use, when NOT to use each, and why a 50-skill pack taxes every task whether it fires or not.

The best Claude Code skills are the few you will actually trigger — not the fifty in a mega-pack. After installing large collections and pruning them against real work, the same handful of categories survive: document and file handling, a house code-review skill, a testing skill, git and PR hygiene, one framework-specific skill for the stack you actually ship, and a docs or changelog skill. This piece is organised around what to cut, because with skills the description field alone taxes your context window whether or not the skill ever fires.

Why "best" means "fewest" for skills

A skill is a SKILL.md file with a trigger-rich description. Per the Claude Code skills docs, Claude reads the descriptions of every installed skill to decide which — if any — to pull into context for the task at hand. That is the whole cost model: the body of a skill only loads when it fires, but its description is always in the running. A 50-skill pack is 50 descriptions competing for attention on every prompt.

---
name: pdf-forms
description: >-
  Fill, read, and extract fields from PDF forms. Use when the user
  mentions a PDF, a form, AcroFields, or attaches a .pdf to process.
---
# instructions load only when the description above matches...

So the question for every skill is not "is this useful in theory" but "is this useful often enough to justify sitting in the routing budget on every unrelated task." Most skills in a big pack fail that test for any one project. Cutting them is not deprivation; it is what makes the survivors fire reliably.

The categories that survive real use

Roughly seven categories keep earning their place across projects. For each: what it does, when to skip it, and the licence note that decides whether you can actually ship it.

1. Document and file handling

Reading, editing and extracting from PDF, docx, xlsx and pptx. Anthropic ships high-quality versions of these in the official anthropics/skills repository, which is the cleanest starting point. Skip it if you never have Claude touch office documents — this is dead weight in a pure-backend project. Licence: use the official repo's declared licence and verify it at the source; do not assume from the README.

2. Code review / house style

Encodes your team's review rubric and style conventions so Claude applies them automatically. Skip it if you already run a review subagent — pick one or the other; running both duplicates the rubric and muddies routing. Licence: most community versions are MIT, but confirm at source before you ship it inside a company.

3. Testing

Writing and running tests the way your project actually tests — the framework, the fixtures, the command. Skip it if your test story already lives in CLAUDE.md and Claude follows it; a skill that repeats your project file is noise. Licence: verify at source.

4. Git and PR hygiene

Commit-message conventions, PR descriptions, changelog-friendly summaries. This one earns its place on any repo with more than one contributor. Skip it if you are on a tiny solo project where none of that ceremony matters. Licence: verify at source.

5. One framework-specific skill for your stack

A skill that knows your web framework, ORM or data stack deeply. Keep exactly one — the one for what you ship. Skip the other twenty language and framework skills a big pack bundles; they are the clearest example of description tax with no payoff. Licence: verify at source.

6. Debugging and error triage

Structured triage of stack traces, flaky tests and error logs. Skip it if you already delegate noisy debugging to a subagent — the subagent's separate context window is usually the better home for it. Licence: verify at source.

7. Docs and changelog

Keeping README sections, API docs and changelogs in sync with changes. Skip it if you do not maintain a changelog or public docs; it will rarely fire and still cost you the description slot. Licence: verify at source.

Skill categoryKeep it whenSkip it when
Document / file handlingYou process PDFs, spreadsheets, docsPure backend, no office files
Code review / house styleYou have a real rubric to enforceYou already run a review subagent
TestingYour test setup needs coaxingIt's already covered in CLAUDE.md
Git / PR hygieneMulti-contributor repoTiny solo project
Framework-specific (one)It matches the stack you shipIt's for a language you don't use
Debugging / triageYou want it in the main threadA debugger subagent already owns it
Docs / changelogYou maintain docs or a changelogYou don't keep either

Big skill packs are mostly overhead

Roundups like Firecrawl's best-skills list are useful for discovering what exists, but a discovery list is not an install list. Installing a whole pack because a listicle named fifty skills is the exact mistake the cost model warns against: you inherit fifty descriptions, a pile of licences you have not checked, and duplicate skills that overlap with your subagents. The measurable win is subtractive — the fewer skills you keep, the more reliably each one triggers, because there is less for Claude to disambiguate against.

A skill you never trigger still costs youUnlike an unused file on disk, an installed skill's description is read on relevant tasks whether or not it ever activates. Fifty rarely-used skills degrade routing for the five you rely on. Deleting is a performance optimisation, not housekeeping.

The licence note most skill lists skip

A SKILL.md file carries a licence exactly like source code does. Community skills range from clean MIT to no LICENSE file at all — which means all rights reserved, not free-to-use. Before you ship a skill inside anything that matters, verify its licence at the source commit; the full process is in license hygiene for Claude Code agents and skills. This is also the strongest argument for writing your own: a skill you author has no licence question and fits your project exactly.

Write the one you needOften the right skill for your project does not exist as a clean, permissively-licensed file — so build it. A focused SKILL.md is an afternoon of work; see how to create one end to end.

How to decide what to keep

  1. Install into a scratch project, not your main repo. Run a week of real work and watch which skills actually fire.
  2. Delete anything that never triggered. If it did not activate in a week of representative work, it will not earn its description slot.
  3. Resolve overlaps. One home per job — a skill or a subagent, a review skill or a review subagent, never both.
  4. Keep one framework skill, for the stack you ship, and cut the rest of the language pack.
  5. Verify the licence of every survivor at source, or replace it with one you wrote yourself.

Do that and your skills directory ends up short, sharp and reliable. The best Claude Code skills list is not the longest one you can assemble — it is the shortest one that still covers your actual work.

Sources

Keep reading