搜 “Claude Code skills” 的人,真正想解决的通常是两件事:第一,技能到底应该放在哪个目录;第二,第一批该装哪些 skill 才不会踩坑。很多目录站会把这两件事混在一起,结果安装说明埋在营销文案里,示例又散落在几十个仓库页面中。
这篇指南把路径和选型拆开。先去看 Claude Code Skills 专题页,再用这篇文章判断哪些 skill 适合放在项目级,哪些更适合做成用户级默认配置。如果你还没有想清楚 Agent Skills 和其他能力层的关系,可以顺手看 Agent Skills 与 MCP。
Claude Code 主要会看两个目录:项目级 .claude/skills/ 和用户级 ~/.claude/skills/。项目级目录适合强依赖仓库结构、团队流程或部署规范的 skill;用户级目录适合那些你在很多项目里都会反复复用的 skill,比如浏览器检查、代码审阅、结构化写作或 SEO 分析。
目录约定应以 Anthropic 官方文档为准,这里不重复定义规范,只给出决策方法。官方文档见:Claude Code skills documentation。
建议第一批只放三类:
这三类 skill 分别对应三种常见价值:把经验抽成模板、把流程落到执行、把输出固定成可复用结构。第一批不要贪多,关键是让你快速形成“技能应该放哪、什么时候调用、输出长什么样”的判断标准。
最实用的规则只有一句话:如果 skill 明显依赖某个仓库的文件结构、命名规范或交付流程,就留在工作区;如果它解决的是你个人在很多项目里都重复出现的任务,就放到用户级。
比如浏览器校验或通用代码审阅,通常可以先作为全局 skill 使用;而 release checklist、仓库治理或团队写作规范,更适合沉淀在项目里。用户搜索 “install Claude Code skills” 时,不只是要一个目录路径,还想知道 portable skill 和 team-specific skill 的边界在哪里。
不要只看仓库首页,优先看 skill 详情页,确认四件事:
这些点清楚了,再放进小项目做一次真实任务验证。很多 skill 乍看文案很漂亮,但只要运行前提模糊,最终都会把“复用”变成“维护负担”。
如果你已经确定要以 Claude Code 为主运行时,下一步就去看 Claude Code Skills 专题页 挑五个候选。若你更想先搞清楚术语和架构,再看 Agent Skills 与 MCP。如果你已经明确任务方向,可以直接跳去 SEO Skills 或 Browser Automation Skills。