聊到skills这个词最近在AI编程圈子里确实火得不行。不管你是用Claude Code、Codex还是OpenCode只要在社区里逛一圈满屏都是skills推荐、skills源网站、怎么手搓skills的讨论。我自己的感受是Skills这东西本质上就是给AI助手装职业说明书。以前我们写提示词是一次性教AI做事写完了就没了现在有了skills你可以把一套完整的工作流程、判断标准、输出规范打包成一个固定技能包让AI在需要的时候自动加载干起活来又快又稳。这篇文章我想认真聊聊我自己折腾skills的完整经历——从它到底是什么怎么手动装GitHub上的开源skills到怎么按场景选skills、怎么写自己的skills最后踩过的坑也一并整理出来。如果你是刚接触这个概念的新手这篇可以直接当入门手册用如果你已经在用了那后面几节关于如何写一个能用的SKILL.md和故障排查的部分应该能帮你解决一些实际痛点。1. 先搞清楚Skills到底是什么1.1 我为什么开始折腾Skills坦白说最早我对skills是持怀疑态度的。Claude Code和Codex本身已经很能打了多一层skills包感觉像是画蛇添足。直到有次我接手一个前端重构任务来来回回跟Claude确认了十几次组件风格统一用xxx类型定义放在src/types里提交信息按conventional commits格式写它还是会在中途跑偏。后来我把这套要求整理成一个skill文件塞进去再跑同样任务一次性就生成了一版完全符合心意的结果。那一刻我明白了skills的作用不是让AI变聪明而是给AI装上行为准则。它锁定的是做事的边界、步骤和输出标准让AI在做同一类事情时不再每次从零猜测你的意图。从原理上讲skills和普通提示词的核心区别在于三点持久性普通提示词是一次性请求关掉对话就失效skill是落盘的结构化文件每次都生效。上下文压缩一套复杂规范如果全塞进对话里可能占掉几千token做成skill之后模型只在任务匹配时才读取核心说明效率高很多。可复用与可分享一个写好的skill可以跨项目使用也能像开源软件一样在GitHub上分享、迭代社区里已经涌现了大量高质量skills集合。1.2 Skill和Prompt、MCP的区别很多朋友会把skills跟prompt、MCP混在一起这三个确实都是围绕AI工作流的东西但定位完全不同。我用一个生活化类比来解释假如AI是一个刚入职的程序员实习生。Prompt是你每次交代任务时的具体指令相当于帮我把这个接口报错看一下。Skill是你给实习生定好的《团队协作手册》里面写了代码规范、提交流程、日报格式他只要接到相关任务就会主动翻开手册照着做。MCP则是你给他配的工具箱和通讯录让他能直接读取数据库、查公司Wiki、操作GitHub。MCP解决的是AI能触达哪些外部系统的问题而skill解决的是知道了系统数据之后按什么套路干活的问题。所以它们不是替代关系而是配合关系。实际项目里MCP负责打通数据和工具skill负责定义行为和产出两者搭配才能把AI从嘴替型助手升级成闭环执行型员工。1.3 一个标准Skill包的内部结构聊安装之前得先知道一个skill包里有什么。以Claude Code生态里最常见的结构为例一个标准skill包的目录结构长这样my-skill/ ├── SKILL.md ├── references/ │ ├── checklist.md │ ├── template.ts │ └── examples.json └── scripts/ └── validate.py其中核心文件是SKILL.md它相当于skill的入口文档模型判断是否要使用这个skill以及具体怎么用主要就是读这个文件。references目录用来放参考材料——规格文档、代码模板、案例输出都可以放这里SKILL.md里通过相对路径引用需要时再读取避免一次加载太多无用内容。scripts目录则可以放辅助执行的脚本比如日志解析、数据校验工具等。理解了这套结构后面安装也好、自己开发也好就能有条不紊了。2. 手动安装GitHub上的Skills以Claude Code为例先声明一下我日常主力工具是Claude Code所以这一节主要讲Claude Code怎么手动装GitHub上的skills。Codex、OpenCode的安装思路差不多但细节我会在文末提一下区别。2.1 准备工作确认环境和目录很多人在第一步就卡住了因为对Claude Code的skills目录机制不熟。claude code会从三个位置读取skills项目级目录.claude/skills/只对当前项目生效适合团队共享、跟仓库走。用户级目录~/.claude/skills/对你本机所有项目生效适合放个人常用的通用技能。插件携带目录通过插件plugin安装的skills由插件统一管理。手动安装指的是前两种。我的习惯是通用技能放用户级项目专属技能放项目级。比如代码审查这种技能放用户级而本项目的模块命名规范这种就放项目级避免污染其他项目。提示安装前先确认你的Claude Code版本是否支持skills。2025年下半年开始官方对skills支持已经比较完善老版本建议升级到最新版否则可能出现装好了却不加载的问题。2.2 手动安装流程拆解手动安装其实就三步下载、放目录、验证。假设我在GitHub上发现一个不错的skill仓库比如awesome-claude-skills里推荐的某个代码审查skill仓库结构是一个包含SKILL.md的文件夹。第一步克隆下载。用Git clone到本地临时目录git clone https://github.com/某个用户/some-skill.git如果仓库是一个合集里面包含多个skill文件夹那就只拷贝需要的那个文件夹即可。第二步复制到目标目录。假设这个skill叫code-reviewermkdir -p ~/.claude/skills cp -r some-skill/code-reviewer ~/.claude/skills/如果装在项目级就复制到项目下的.claude/skills/目录。复制后检查一下结构find ~/.claude/skills/code-reviewer -type f | sort正常应该能看到SKILL.md和其他辅助文件。第三步验证加载。重启Claude Code会话然后用自然语言触发相关任务。比如这个skill是代码审查类的我可以直接对它说审查一下src/utils.ts的代码。在调试模式/debug下可以看到模型是否加载了对应skill。注意部分合集仓库里的skill文件夹名可能带版本号或作者名建议复制后重命名为语义清晰的短名称比如code-reviewer目录名会被作为skill的标识符用于匹配和引用。2.3 安装后验证与常见安装失败原因装完没生效是群里被问得最多的问题。我总结过几个高频原因目录层级不对多套了一层文件夹。比如克隆了一个repo目录里面还有一层code-reviewer结果你直接把repo整个放进了skills目录。这样模型扫描不到有效skill。正确做法是~/.claude/skills/下面直接放包含SKILL.md的文件夹不能再来一层。大小写不一致Claude Code对目录名大小写敏感Code-Reviewer和code-reviewer会被当成两个不同skill如果触发词引用的是小写就有概率匹配不上。SKILL.md内容为空或不规范没有Frontmatter结构化元信息或缺少描述字段导致模型判断不出该什么时候使用它。遇到这类问题最快的方法是用/skills命令查看当前已加载的skills列表确认目标skill在不在里面。如果不在按上面三个原因逐一排查。3. 场景化Skills推荐与配置思路GitHub上skills仓库多如牛毛但真正能提升效率的是贴合你实际场景的那几个。我按照社区讨论热度和我自己的使用体验把skills按场景分成几类每个场景列几个我认为值得装的并附上配置时的思路。3.1 数学建模比赛向Skills华为杯国赛这类数学建模赛事最近有不少人讨论用skills来辅助建模。我的看法是建模比赛的难点从来不是写代码而是快速理解题目、拆解问题、选模型、组织论文。所以这个场景下真正好用的skill应该聚焦在套路化环节。比较受推荐的是这几类问题分析skill拿到赛题后自动引导你进行Problem Statement拆解列出目标、约束、可用的数据来源、需要做的假设。这种skill的SKILL.md里通常会包含一套Socratic提问模板逼着你和AI一起把题目吃透。论文排版skill国内数模论文有固定格式要求摘要、问题分析、模型建立、求解、优缺点评价一个排版skill能强制输出符合格式规范的Markdown/LaTeX骨架。算法选型skill针对数据量小但精度要求高数据量大但实时性要求高等不同场景推荐合适的模型家族并附上已有实现样例。配置思路方面我强烈建议把这类skill装上之后单独建一个models/子目录放算法模板因为在比赛场景下拼的不是模型多新颖而是谁能更快把基线版本跑通。3.2 前端开发向Skills前端是skills渗透最深、产出最成熟的领域。原因很现实前端规范多、组件化程度高、重复模式多非常适合固化成语义明确的skill。社区里好评度比较高的前端skills包括Vue/React组件开发skill内置组件结构规范、props/events命名约定、样式方案Tailwind/CSS Modules。实操中我让AI生成新组件时它甚至能自动补齐组件注释和测试用例。代码审查skill检查类型定义、边界条件、性能隐患不必要的re-render、可访问性a11y。这个skill我用的频率最高几乎每个合入请求前都让它过一遍。重构skill把长函数拆分、抽取公共逻辑、清理死代码。它跟代码审查配合起来是先审后改的完整闭环。前端类的skill安装后我建议每个项目目录下放一份.claude/skills/副本因为你在A项目里的组件规范不一定适用B项目。项目级安装保证多项目并行时互不干扰。3.3 AI漫剧创作向SkillsAI漫剧这个场景最近蹿升速度很快。所谓AI漫剧就是用AI工具批量生成分镜脚本、画面提示词、配音文案再剪辑成短剧。这个流程里耗时最大的是角色一致性和分镜脚本规范性skills恰好能解决这些问题。实操向的skills配置思路角色设定skill维护每个角色的人设档案外貌、性格、说话风格、常见动作SKILL.md里写明每次生成画面提示词时必须引用对应角色的固定外貌描述词保证不同集数里角色长得一致。分镜脚本skill定义分镜表格式——镜号、景别、运镜、画面描述、台词、时长、音效提示。它保证你产出的脚本可以直接丢给视频生成工具或人工剪辑不用二次整理。字幕与文案skill统一字幕断句规则、口语化改写、黄金三秒开头模板。安装这类skill时有个小建议把角色设定写进references目录而不是直接堆在SKILL.md里。因为角色档案会越加越长如果让模型每次读取完整档案token消耗会很大。放references后模型只有在关键环节才去查对应角色的详细设定。3.4 优质Skills源网站汇总最后整理一份我常逛的skills来源社区热词里反复出现的基本就是我收藏的这些来源说明适合人群GitHub上知名的skills合集仓库如awesome-claude-skills生态覆盖面广但质量参差刚入门先泛览官方Skills示例目录结构规范可直接当教学模板想了解标准写法的人Cola Skills及相关衍生包偏真实场景更新快中高阶玩家Superpowers等强调超能力的技能集主打自动化工作流编排追求效率的人说句实在话技能的长期价值远比某个具体包重要。你从上面任何源里找到了几个顺手的skill一定要打开SKILL.md读一遍看看作者是怎么设计触发条件、怎么组织步骤的这个习惯能帮你后面自己写skill的时候少走很多弯路。4. 从零开发一个自己的Skill按我自己的经验只有到了为具体场景重写/自建skill这一步你才真正把skills用活了。这一节我把手写skill的全过程拆开讲从Frontmatter到自己调试一条龙走完。4.1 SKILL.md的Frontmatter规范每个SKILL.md顶部必须有一段YAML格式的 Frontmatter它相当于skill的身份证。不同工具对字段要求略有差异但核心的几个是通用的--- name: code-reviewer description: 当用户要求审查代码、检查代码质量或提交PR前审查时使用该技能。输入为源代码或文件路径。 ---这里最容易被忽略的是description的写法。一个好的description应该包含两个信息什么场景触发输入是什么。我见过很多新手写这是一段代码审查技能太模糊模型根本不知道什么时候该调用它。注意description是模型判断是否调用skill的主要依据务必写清楚当……时和输入……宁可啰嗦也不要模棱两可。4.2 正文怎么组织才容易被模型执行看完FrontmatterSKILL.md正文是核心。我建议正文遵循三个原则第一按步骤拆分明确先后顺序。如果你希望模型先分析再给建议就直接写Step 1列出问题清单Step 2按严重程度分类Step 3给出修改建议。第二写明产出格式。比如代码审查skill可以规定输出表格的列名是文件、行号、问题类型、严重级别、修改建议。这样不同批次的审查结果格式统一方便你后续聚合统计。第三提供判断标准。AI和人类最大的差距在于缺少什么算好什么算坏的评判依据。所以在skill里要用明确的规则描述。比如禁止使用any类型、函数行数不宜超过50行、需要包含边界条件测试。下面是我的一个真实SKILL.md片段供参考--- name: doc-writer description: 当用户需要为Python模块或函数编写README和docstring时使用该技能。输入为模块路径或函数签名。 --- # 文档编写技巧 ## 工作流程 1. 提取输入代码的公共接口函数名、参数、返回值、异常。 2. 为每个公共接口生成docstring要求包含参数说明、返回说明、使用示例。 3. 汇总生成README片段包含安装方式、快速开始、API列表。 ## 输出规范 - docstring使用Google风格参数类型标注准确。 - README示例代码必须是可运行的禁止省略import语句。一般建议正文控制在100-200行以内。过长会让模型在判断时犹豫反而降低触发率。4.3 参考文件与脚本的组织方式前面提到过references和scripts目录开发自建skill时这两个目录能显著提升效果。references里放的是不必要每次读取、但需要时可查的内容。以我的Vue组件开发skill为例vue-component-builder/ ├── SKILL.md └── references/ ├── component-template.vue # 组件模板 ├── style-guide.md # 团队样式规范 └── examples/ # 两个完整的组件示例 ├──>