Claude Code Skills 完整指南：是什么、怎么用、用哪些

TL;DR

我是 Jim Liu，悉尼独立开发者，运营 9 个站。Claude Code Skills 每天用了 3 个多月。
Claude Code Skills = 可复用的指令剧本——把一套流程写成 Markdown，之后用斜杠命令随时调用
文件存在 ~/.claude/skills/，不是代码包，是 Claude 直接读取的 Markdown
跟 MCP 工具不同：MCP 扩展 Claude 能做什么，Skills 定义 Claude 如何做某件具体的事
我最常用的三个：obra/superpowers（代码审查）、OpenSpec（API 文档）、自己写的关键词研究 skill
每个 skill 安装约 10 分钟。如果你在 Claude Code 里重复做同类任务，值得装

我是谁，为什么我来写这篇

我叫 Jim Liu，悉尼独立开发者。我做 openaitoolshub.org——就是这个站——还有另外 8 个项目，包括港股投资工具、AI 植物识别 App、几个 Roblox 游戏攻略站。

2026 年初开始用 Claude Code，现在每天要花 4–6 小时。三个月里装过 30–40 个 Skills，自己写了 4 个，看着生态从一堆散落的 GitHub 实验品长成了有成千上万 community 贡献流程的 marketplace。

大多数关于 Claude Code Skills 的文章，要么是官方文档，要么是明显没跑过的两段概述。这篇是我每周实际在用的东西。

Claude Code Skill 到底是什么

一个 Claude Code Skill 就是一个 Markdown 文件，里面写了 Claude 要遵循的指令。就这么简单。

举个最精简的例子：

---
name: check-security
description: 检查文件的常见安全漏洞
---

检查 $1 文件里的以下问题：
1. SQL 注入和输入校验漏洞
2. 认证和授权逻辑
3. 硬编码的密钥或 API key

输出一张表：问题 | 严重程度 | 行号 | 修复建议

把这个保存到 ~/.claude/skills/check-security/SKILL.md，然后在任何 Claude Code 会话里输入 /check-security src/api/auth.ts，Claude 就会读取 skill 指令、应用到你的文件，返回结构化结果。

没有构建步骤，没有包安装。就是一个 Claude 直接读的 Markdown 文件。

格式简单到 15 分钟可以写出一个基础 skill，但真正好用的——能处理边缘情况、输出稳定——需要反复打磨。

Skills 和 MCP 工具的区别——这个总被搞混

几乎每篇 Claude Code 文章都会把这两个概念混在一起。快速区分：

MCP 工具扩展 Claude 能访问什么——网络搜索、数据库查询、外部 API。它们是能力扩展，给 Claude 新增操作类型。

Claude Code Skills 定义 Claude 怎么处理你已经定义好的特定任务。它们是你写好存起来的工作流程。

两者经常配合用。MCP 工具给 Claude 连上某个搜索 API，Skill 告诉 Claude 具体怎么构造查询、提取哪些字段、用什么格式输出——这样你就不用每次会话重新解释。

想看详细对比，我之前写了一篇 Claude Code Skills vs Plugins。

怎么安装

# 从 GitHub 克隆到 skills 目录
git clone https://github.com/obra/superpowers ~/.claude/skills/superpowers

# 或者用官方 CLI（针对已上架的 skills）
claude skills install <skill-name>

# 下次启动时确认加载成功
claude --list-skills

维护良好的 skill 仓库都有 README 说明是否需要配置文件或环境变量。装之前先看 README——有些 skill 在配置不完整时静默失败，你根本不知道为什么结果不对。

我实际在用的 Skills

三个月里用过不少，现在稳定留下来的：

obra/superpowers 是我用得最多的。对整个代码库做 code review，不是只看单个文件。它能发现逐文件审查漏掉的模式——跨 endpoint 不一致的认证逻辑、不同模块间错误处理风格不统一、特定路径的测试覆盖缺口。重要 PR 合并前我必跑一遍。中等规模的代码库用时 3–5 分钟，每次都能发现我没看到的东西。

OpenSpec 从代码或自然语言描述生成结构化 API 规范。我在三个站点的 API 上跑过。它不会直接产出可以上线的 spec，但初稿工作省了不少——我估计 60–70% 的 spec 工作它能完成，剩下才是我手动补的。完整使用体验见 OpenSpec 评测。

我自己写的 blogtool-newword-hunter 是专门为 9 个站做关键词研究的 skill，单个命令跑 SEMrush 搜量查询、SERP 饱和度分析、已写文章去重。这篇文章就是靠它找出来的——"claude code skills" 1900 月搜量、KD 32%，标了 GO_WRITE_NOW。

想看 Skills 在真实开发日里怎么使用，可以看 Claude Code 工作流案例。

在哪里找 Claude Code Skills

claude.com/skills — 官方目录，上架的 skill 都经过审核，比随机 GitHub 仓库可靠。
GitHub — 搜 claude code skills 或 awesome-claude-skills。选择更多，也更实验性。装之前看一下最后提交时间。
Claude Skills Marketplace — 社区维护的目录，4000+ skills，官方目录没覆盖的类型这里基本都有。我写了一篇各来源对比文章。
r/ClaudeAI — 开发者分享自己为特定工作流写的 skill。粗糙但很实用。

我踩过的四个坑

装太多。 第一周就装了 15 个。会话启动变慢，而且我一直在跑自己没搞清楚的 skill。5–6 个真正了解的比 20 个只是装着强多了。

没看参数。 大多数 skill 有参数可以改变行为。obra/superpowers 用了两周默认参数，才发现有个 --scope security 标志可以专门聚焦在认证和注入问题。加了这个之后 review 质量明显提升。

信任了弃坑的仓库。 GitHub 上有些 skill 从 Claude Code 0.9 就没更新过。技术上能跑，但缺少后来加的特性。装之前查一下仓库最后提交时间。

装了就以为能用。 Skill 静默失败。调用 skill 但输出看起来不对时，打开 ~/.claude/skills/{name}/SKILL.md 看一下。通常是某个必要参数或环境变量没设。

Skills 的局限性

Skills 是指令文件，不是代码。没有状态，没法编程式地捕获错误，可靠性取决于 Claude 遵循指令的一致性——而这并不总是稳定的。

复杂的多步骤工作流有时会漂移。Claude 前三步按 skill 指令走，第四步就开始即兴发挥了。涉及生产数据或要求精确输出格式的任务，我把 skill 输出当初稿，还是手动审一遍。

重复性低风险任务——写文档草稿、汇总代码、生成样板代码、结构化研究——Skills 持续有用。涉及线上数据或格式有严格要求的，先验证再用。

FAQ

Claude Code Skills 和 Claude AI Skills 平台有什么区别？ "Claude Skills"被两种东西混用了。Claude Code Skills 是本地 ~/.claude/skills/ 里的 Markdown 文件，在 Claude Code CLI 会话里跑。Anthropic 的 Claude AI Skills 平台是用于构建外部集成的独立框架。两套系统，两套配置。

没有编程基础能写 Claude Code Skill 吗？ 可以。是 Markdown 文件。能写清楚的分步指令就能写 skill。难点在于精确——模糊的指令产出模糊的结果。

Skill 会占用 Claude Code 的 context window 吗？ 会。Skill 文件在会话启动时加载进 context。复杂的大 skill（几千 token）会拖慢启动并占用本来留给代码库的空间。条件允许的话把 skill 文件控制在 2000 token 以内。

有没有面向非开发者的 Skill？ 这个类别在增长。我见过写作工作流、市场调研、数据格式化、内容日历规划的 skill。面向开发者的更成熟，非开发场景也在追上来。

Windows 上 skill 目录在哪？ C:\Users\{用户名}\.claude\skills\ — 同样的结构，不同的路径分隔符。Claude Code CLI 自动处理路径差异。