我随手把技能目录命名成 my-skill-v1,里面 SKILL.md 的 name 字段写的却是 code-review,装完怎么都不对,折腾了小半天才定位到是命名不一致。
这篇整理的是作者从 beta 期就一路装过、跑过、在真实项目里用过的 17 个 Claude Code Skill。下面挑装和用最容易踩的地方讲。(原文有删节)
Skill 到底固化了什么
普通 Prompt 是一次性的。你问「这段代码有什么问题」,它看完答完对话就结束,下次同样的事还得重新说一遍,表述稍微变一点,输出还会飘。
Skill 把一组执行流程固化成一个文件包,里面有任务拆解步骤、工具调用规则、输出模板和质检项。Claude Code 先读 SKILL.md 的 description 字段,判断当前任务匹配哪个技能,再按里面的流程一步步走。
作者挂了代码评审 Skill 之后,评审报告从随想变成了固定格式的问题清单加修改建议,稳定性和可复用性完全是另一个级别。
Skill 和 MCP 分工在哪
把插件生态比作厨房,MCP 解决的是能不能碰到外部工具,比如查数据库、操作浏览器、调第三方 API;Skill 解决的是拿到工具之后怎么干活。
两者是配合关系。Skill 配置里有一个 allowed-tools 字段,声明这个技能运行期间允许调用哪些工具,其中就包括 MCP Server 暴露出来的能力。一个「运营周报」Skill,可以先通过 MCP 拉数据库里的业务数据,再按固定模板生成周报。

三条安装路径,按环境挑
终端最通用。机器上有 Node.js 18 以上,执行 npm install -g @anthropic-ai/claude-code,装完敲 claude –version,看到版本号就成了。Windows 下 CMD 和 Git Bash 都能跑,终端编码偶尔乱码,把代码页切到 UTF-8 就行。
主力在 VSCode 的就再装官方扩展。在 settings.json 里指定 claude-code.path 指向全局的 claude,插件模式会跟着当前工作区走,打开哪个项目就加载哪个项目的 .claude/skills,在多项目之间切换省事。
不熟命令行的可以用桌面版,走官方渠道下载安装包。作者实测遇到下载失败,多是网络波动或本地安全软件拦截。市面上打着「加速下载」「一键破解」旗号的包别碰,这类东西风险极高。
装完没生效,先查这三件事
这一条作者踩得最久。
第一看目录位置。全局技能放 ~/.claude/skills/,项目级的放项目根目录下的 .claude/skills/。层级放错,它就不在对应的加载范围里。
第二看 SKILL.md 的文件名和大小写是否准确。
第三看 YAML frontmatter 有没有语法错误。按作者的说法,这三处的出错概率占九成以上。
还有一个容易忽略的点。Claude Code 加载技能时会检查目录名和 SKILL.md 里的 name 字段是否一致。不一致虽然理论上也能加载,但触发和调用的成功率会明显下降。作者就是把目录命名成 my-skill-v1、name 写成 code-review,卡在这儿半天。

验证有没有加载,有三种问法
打开交互界面输入 / 看命令列表,已加载的技能会列在里面。也可以直接问一句「你现在加载了哪些技能」,装对了它会报出技能名和功能描述。第三种是半自动的:直接触发它的使用场景,比如说「用代码评审技能检查一下当前改动」,看它的行为是否按技能文件里定义的流程走。
自己写一个,从单个 SKILL.md 起步
标准目录结构里核心只有一个 SKILL.md,prompts/、scripts/、assets/ 都是可选的加分项。作者的建议是先写单个 SKILL.md,跑通了再拆 prompts 和 scripts。
有项目级需求就别放全局,放项目根目录的 .claude/skills/,跟着 git 一提交,团队其他人拉下来自动就能用,适合把团队级的标准流程沉淀下来。
那 17 个技能里,开发提效类的用得最勤。skill-247 把大重构拆成批次,每批跑完自己检查、写进度再继续;1m-context 遇到超长文件先切片摘要和索引,再按需深入具体段落;prompt-ultra 把模糊需求改写成含角色、目标、约束、步骤和输出格式的完整模板。
一分钟速查

常见问题
问:Skill 和 MCP 是什么关系?
答:MCP 解决能不能碰到外部工具,Skill 解决拿到工具之后怎么干活。Skill 用 allowed-tools 声明运行期能调哪些工具,里面就包括 MCP Server 暴露的能力。
问:装到全局还是项目里?
答:自己常用、跨项目都要的放 ~/.claude/skills/;团队共享、要跟着仓库走的放项目的 .claude/skills/。
问:技能目录里带脚本跑不起来?
答:检查脚本有没有执行权限,Linux 和 macOS 上偶尔要手动 chmod +x。
问:怎么算装对了?
答:输入 / 看列表,或者直接问它加载了哪些技能,装对了会报出技能名和功能描述。
来源与编译
本文转载自CSDN(weixin_29061531) 《Claude Code Skill 实战:17个亲测高效技能包与安装指南》,原文链接:https://blog.csdn.net/weixin_29061531/article/details/169758116。版权归原作者所有,如需删除请联系我们。