Key takeaways
- Skills ≠ MCP: Skills are procedural memory (SOPs); MCP is live tool hands — complementary, not interchangeable.
- P0 zero-install: bundled
/code-review,/debug,/loop,/run,/verifyship every session — many users never trigger them. - P1 official must-install:
skill-creator(author your own) + Document Skills (real PDF/DOCX/XLSX file handling). - P2 workflow trio:
grill-me(align before coding),handoff(cross-session / cross-Agent handoff),superpowers(multi-step TDD orchestration). - Two skill types: Capability Uplift (teaches new abilities) vs Encoded Preference (locks team style) — installing the wrong type wastes effort.
- 24/7 long runs: Skills and
~/.claude/skills/need a host that stays online; see Cloud Mac rollout at the end.
1. Why Skills are worth more than stacking CLAUDE.md
Many teams dump every convention into CLAUDE.md, burning thousands of tokens each session while Claude may still skip steps. Skills win on progressive disclosure: at startup Claude reads only each skill's name and description (~100 tokens/skill); the full SKILL.md loads only when the task matches. Irrelevant skills stay out of context — baseline Agent engineering in 2026.
Official docs define Skills as directories following the Agent Skills open standard. Claude Code extends that with dynamic context injection (!`git diff HEAD`), context: fork sub-agent runs, disable-model-invocation, and more. The same SKILL.md can be read by Cursor, Codex CLI, and GitHub Copilot — the real dividing line is routable workflows, not model IQ.
If you are moving Claude Code to an always-on host, start with our article on why more teams run Claude Code on Cloud Mac; this guide assumes you already run the claude CLI locally or on a remote Mac.
Model IQ is not the dividing line — routable workflow entry points are.
2. Four tiers: bundled / official plugin / project / community
Before installing anything, know where a skill comes from — trust level and update path differ completely:
| Tier | Path | Scope | Examples |
|---|---|---|---|
| Bundled | Shipped with Claude Code | Available every session by default | /code-review、/debug、/loop、/run、/verify |
| Official Plugin | /plugin marketplace add or claude.com/plugins |
Personal or organization | skill-creator、Document Skills、claude-api |
| Project-level | .claude/skills/ or nested monorepo directories |
Shared with everyone who clones the repo | team deploy flow, API standards, /run-skill-generator output |
| Community | ~/.claude/skills/ or npx skills add |
Personal, cross-project | handoff、grill-me、Vercel suite、Firecrawl |
2.1 Capability Uplift vs Encoded Preference
Use this binary filter to eliminate ~80% of useless installs:
- Capability Uplift: Claude cannot reliably do the task without it — Playwright browser tests, PDF form parsing, CodeQL security scans. You are installing a new toolchain.
- Encoded Preference: Claude already can, but you want it done your team's way — Karpathy's four coding rules, Vercel's 57 React performance rules, your PR description template.
If output feels too generic and "not like our team wrote it" → you need Encoded Preference. If Claude "simply cannot do this task" → you need Capability Uplift.
3. Five dimensions: entry, execution, context, cost, permissions
This table compares Skills with other extension styles using one header set — avoid mixing "Skills vs Rules vs MCP" arguments:
| Approach | Entry | Execution | Context | Cost | Permissions | Best for |
|---|---|---|---|---|---|---|
| CLAUDE.md | Auto-loaded every session | Prompt-level, no scripts | Fully resident | High fixed token overhead | Follows project files | Short facts, directory notes |
| Skills | /skill-name or auto-routed |
SOP + optional scripts/ | Progressive, on-demand load | Low index + expand on hit | Personal / project / enterprise tiers | Repeat workflows, team standards |
| MCP Server | Tool invocation | Live API / DB / Git | Tool results re-injected | API + round-trip latency | Explicit config and approval | External system integration |
| ECC full kit | Plugin + Hooks | 246+ Skills + memory Hooks | Hooks summarize across sessions | Install + Hook config cost | Team needs unified profile | Large-team engineering |
ECC (Everything Claude Code) is a kit-level option for enterprise teams who want everything at once; individuals should follow this article's P0–P4 progressive install. See Is ECC worth it? for the full ECC verdict.
4. P0–P4 install priority ranking (decision core)
This is the most important table in the article — sorted by priority, not popularity:
| Priority | Skill / bundle | Type | Install | Why this rank |
|---|---|---|---|---|
| P0 | /code-review、/debug、/loop | bundled | Zero install — run /code-review directly | Covers review → debug → controlled batch loops on the main path |
| P0+ | /run、/verify、/run-skill-generator | bundled (v2.1.145+) | On complex projects run /run-skill-generator to record startup recipe | Lets the Agent verify against a running app, not just green unit tests |
| P1 | skill-creator | Official Capability | /plugin marketplace add anthropics/skills | If you can install but not author, your list stays on someone else's GitHub forever |
| P1 | Document Skills (pdf/docx/xlsx/pptx) | Official Capability | Same anthropics/skills repo | Real file read/write — not "pretend to generate a PDF" |
| P2 | grill-me、handoff | Community workflow | npx skills add mattpocock/skills -y -g | Align before coding + cross-session handoff — prevents context rot |
| P2 | superpowers、Karpathy Guidelines | Encoded Preference | skills.sh or GitHub clone to ~/.claude/skills/ | Multi-step TDD orchestration + think-before-write discipline |
| P3 | Vercel trio (React / UX / Composition) | Stack-specific | vercel-labs official repos | Highest ROI for React/Next teams |
| P3 | frontend-design、webapp-testing | Capability | anthropics/skills + Playwright | UI quality + real browser regression |
| P3 | Trail of Bits Security | Capability | Official partner plugin | CodeQL / Semgrep vulnerability scanning |
| P4 | Firecrawl、Remotion、Caveman、Context Mode | Scenario-specific | Each official CLI / skills add | Crawl, video code, token savings, session recovery — install only with a clear need |
5. 18 skills reviewed one by one
Sorted by actual invocation frequency in our tickets and internal testing, with a one-line decision rationale. Official docs: Extend Claude with skills.
5.1 P0: bundled (many users never discover these)
/code-review— Structured diff review with a checklist layer beyond casual "take a look." Run before every PR./debug— Guides systematic troubleshooting so the Agent does not thrash random edits. Zero-install alternative to communitysystematic-debugging./loop— Controlled loops for repetitive tasks (batch renames, multi-file migrations) — safer than hand-rolled bashforloops./run+/verify— The most "product-like" bundled combo in 2026: start the app and validate runtime behavior, not just green unit tests. Complex monorepos should run/run-skill-generatorfirst to record DB, env, and multi-step build recipes into.claude/skills/run-*/./batch— Orchestration entry for bulk file operations — ideal mechanical cleanup after codegen.
5.2 P1: official must-install
skill-creator— InteractiveSKILL.mdgeneration. The meta-skill of 2026: if you cannot author skills, your list stays frozen on someone else's GitHub.- Document Skills — PDF form extraction, DOCX annotations, XLSX parsing. Capability Uplift: without them Claude can only describe documents; with them it manipulates real files.
5.3 P2: workflow trio
grill-me(Matt Pocock) — Interrogative plan alignment before coding; dissolves design dependencies one by one. Cures Agents charging ahead on wrong assumptions.handoff(Matt Pocock) — Compresses a session into structured markdown for a new session or Codex worktree handoff. Near 120k context, better than/compactfor "continue on a fresh thread."superpowers— Multi-step sub-agent orchestration with TDD discipline for medium-to-large features.- Andrej Karpathy Guidelines — Four rules: think before coding, stay simple, surgical edits, goal-driven work. Encoded Preference exemplar.
5.4 P3: stack-specific picks
- Vercel Web Design Guidelines — 100+ accessibility and UX audit rules for design-system teams.
- Vercel React Best Practices — 57 React/Next performance rules — reduces "runs but slow" AI code.
- Vercel Composition Patterns — Compound components instead of boolean-prop hell.
frontend-design(Anthropic) — Pulls UI from "AI slop" toward shippable quality.webapp-testing— Playwright-driven local app E2E regression automation.- Trail of Bits Security — CodeQL + Semgrep; recommended default for security-sensitive repos.
5.5 P4: install only with a clear scenario
- Firecrawl — Reliable web scraping and search when Agents need external data. Capability Uplift; requires API key.
- Remotion Best Practices — Deep programmatic video (React) knowledge — video engineering teams only.
- Caveman — Strips narrative filler, saving ~65% output tokens on long sessions.
- Context Mode — Filters shell noise; restores state on session reset.
code-simplifier— Readability-only edits without logic changes — great before PR merge.
6. Scenario matrix: who you are, what to install
| Role | P0–P1 | P2 workflow | P3 stack | Skip |
|---|---|---|---|---|
| Solo full-stack | full bundled set + skill-creator | grill-me + handoff + Karpathy | frontend-design + webapp-testing | ECC full profile in one shot |
| React/Next team | same + Document Skills | superpowers | Vercel trio | Remotion (unless doing video) |
| iOS / macOS engineer | bundled + /run-skill-generator for xcodebuild recipe | handoff (essential for long sessions) | Trail of Bits (if mixed C/ObjC code) | iOS community skills on Linux |
| Tech lead / architect | skill-creator + project .claude/skills/ | grill-me as design review gate | ECC minimal (optional) | Unaudited anonymous Hub skills |
| 24/7 Agent host | bundled + handoff persistence docs | Context Mode | Firecrawl (monitor external changes) | Laptop lid as production machine |
iOS teams wiring Skills into CI should read our iOS 18 CI/CD end-to-end guide; multi-worktree parallel layout: remote Mac worktree short lease.
7. Recommended stacks
Three copy-paste skill stacks for your team wiki:
【Solo dev · minimal stack】
P0: /code-review /debug /run /verify
P1: skill-creator
P2: grill-me → before starting | handoff → before session switch
Install: npx skills add mattpocock/skills skill=grill-me,handoff -y -g
【React product team stack】
Minimal stack +
P3: vercel-react-best-practices vercel-web-design-guidelines
frontend-design webapp-testing
Project-level: .claude/skills/deploy/SKILL.md (team release SOP)
【Security-sensitive backend stack】
Minimal stack +
P3: trail-of-bits-security (CodeQL + Semgrep)
P2: Karpathy Guidelines (surgical edit discipline)
Forbidden: unaudited community skills with scripts/
8. Six common pitfalls
- Pitfall 1: "More Skills = better" — index is light, but vague descriptions cause routing chaos. Solidify P0–P2 first, then expand.
- Pitfall 2: "Skip bundled, install community" —
/runand/verifyare 2026 flagship capabilities many users never trigger. - Pitfall 3: "Skills replace MCP" — Skills teach process; MCP connects live systems. Coding usually needs both.
- Pitfall 4: "Write broad descriptions for easier triggering" — backfires. Use routing sentences like "Use when user asks to X".
- Pitfall 5: "Install ECC full and stop picking" — 246 skills + Hooks have learning and conflict cost; individuals use minimal, teams PoC first.
- Pitfall 6: "Laptop lid does not affect Skills" —
~/.claude/skills/is local, but long sessions and/loopbatch jobs need the host online; production Agents belong on Cloud Mac.
9. 7-step rollout and 48-hour acceptance
- Check version:
claude --version≥ 2.1.145 (/runseries requires it). - Validate P0: run
/code-reviewand/debugon a real repo; confirm slash commands respond. - Record complex startup:
/run-skill-generator— write commands to.claude/skills/run-*/and commit to Git. - Install P1:
/plugin marketplace add anthropics/skills— enableskill-creatorand Document Skills. - Install P2:
npx skills add mattpocock/skills skill=grill-me,handoff -y -g; walk grill → implement → handoff on a real task. - Add P3 by stack: React teams add Vercel trio; security teams add Trail of Bits — use each once before keeping it.
- 48h acceptance: close laptop 8 hours, SSH back into Claude Code, confirm project skills and handoff docs still accessible; if broken, evaluate Cloud Mac rental options for a 24/7 node.
10. FAQ
Q: Are Claude Code Skills compatible with Cursor Skills?
A: Both follow the Agent Skills standard; the same directory can symlink to ~/.claude/skills/ and ~/.cursor/skills/. Claude Code-only extensions like context: fork and dynamic !`command` injection may behave differently in Cursor — test after migration.
Q: Do bundled skills need installation?
A: No. Unless you set disableBundledSkills, /code-review, /debug, /loop, /run, /verify are available every session.
Q: What is the relationship between .claude/commands/ and Skills?
A: In 2026 they merged — .claude/commands/deploy.md and .claude/skills/deploy/SKILL.md both produce /deploy, but Skills support attached files and richer frontmatter. Use Skills for new workflows.
Q: Are community Skills safe?
A: Read the full SKILL.md and audit network calls in scripts/ before install. Prefer anthropics, vercel-labs, trailofbits sources; anonymous skills.sh entries are untrusted by default.
Q: Do project-level skills go into Git?
A: .claude/skills/ should be version-controlled so clones share them; personal prefs go in ~/.claude/skills/. Monorepos can nest skills per package (e.g. apps/web:deploy).
11. Summary
The 2026 Claude Code Skills ranking is a workflow-gap → install-order map, not a GitHub Star list. P0 bundled is zero cost yet often ignored; P1 skill-creator decides whether you can build your own; P2 grill-me and handoff solve the hardest Agent problems — alignment and handoff; P3+ stacks React, security, crawling as needed. Remember: model IQ is not the dividing line — routable workflow entry points are.
Run Claude Code + Skills 24/7 on Cloud Mac
Claude Code Skills pay off through repeat invocation — ~/.claude/skills/, project .claude/skills/, and MCP config need a 24/7 online macOS host with stable paths. Closing a laptop breaks long sessions; M4 unified memory handles local inference and multi-worktree parallelism; native Unix lets /run-skill-generator recipes reuse in CI.
Moving Agent workflows from occasional local use to team always-on? kvmboot Cloud Mac mini M4 supports 48-hour daily rent for acceptance — view plans, validate P0–P2 first, then lock monthly baseline.