最近一直在折腾 Claude Code 的 Agent Skill这东西刚出来的时候我就盯着了前后试了社区里不少技能包踩了不少坑也顺手攒下来一份自己天天在用的清单。这篇就把我这段时间的成果整理出来17 个亲测能打的 Skill外加一个一键安装脚本跑完一条命令全部装进~/.claude/skills。不管你是刚接触 Claude Code 的新手还是想搞明白 Skill 机制、准备自己写技能包的进阶玩家这份内容都能直接抄作业。先说结论Skill 和以前那种把一段提示词复制进 CLAUDE.md的玩法完全不是一个量级。它相当于给 Claude Code 装了一套带说明书、带脚本、带模板的完整工具包装好之后你说一句帮我装个 ROS它不用再反复问你环境、版本、源直接照着 Skill 里写好的流程干。接下来我会把 Skill 的原理拆开讲清楚再把 17 个技能包按类别列明白最后附上完整的安装脚本和踩坑经验。1. 先聊透Claude Code 的 Skill 到底是怎么一回事Skill 在 Claude Code 里其实不是一个多神秘的东西它的核心就是一套约定好的文件夹结构。每个 Skill 对应~/.claude/skills/下的一个子目录里面必须有一个SKILL.md文件这个文件的开头是一段 YAML 格式的元信息包含name和description下面是正文用 Markdown 写这个技能的使用场景、操作步骤、注意事项和示例。关键是这段description它不是摆设而是 Claude Code 在会话里判断什么时候应该调用这个技能的依据。模型会先把所有已安装 Skill 的描述扫一遍如果你的问题跟某个描述匹配度高它才会去读这个 Skill 的完整内容然后把里面的指令带入当前对话。这就像你工具箱里摆了一堆专用工具每个工具上挂了个标签Claude 会看标签找工具而不是把整个工具箱倒在地上翻。那它跟 subagent子代理有什么区别两者容易搞混。子代理是一个独立的小模型实例有自己的 system prompt能独立执行一长串任务Skill 则更轻量它不启动新模型只是给当前对话临时注入一份操作手册。好处是开销小、响应快、上下文不会被切走特别适合那些你知道怎么做、只是不想每回都重新解释的重复性工作。我自己的体会是Skill 最适合解决三类问题一是环境配置类把各种安装命令、版本兼容表、踩坑记录固化下来二是内容生成类把文章改写、备课、润色的规范写进技能包输出风格稳定三是工具链类把模型切换、搜索增强、上下文管理这些日常操作做成标准流程。这 17 个技能包基本就是这么分类的下面一一拆开说。2. 17 个亲测可用的 Skill 清单2.1 先看整体我用一张表列清楚这 17 个技能包序号技能名目录名主要作用适用场景1ros-one-clickROS 1 / ROS 2 一键安装与环境配置Ubuntu 装机、机器人开发起步2keil5-installKeil5 保姆级安装引导嵌入式 Windows 开发环境3cpp-thirdparty-libsC 第三方库的一键整合与 CMake 配置引入 OpenCV、Eigen、Boost 等项目4py-version-managerPython 多版本管理一键切换Windows/Linux 上维护多个 Python 版本5stm32-assistantSTM32 工程配置与调试辅助单片机开发、寄存器配置6cangjie-dev仓颉语言开发助手仓颉项目初始化、语法与构建7de-ai-writer去 AI 味的内容改写博客、文案、报告去模板化8lesson-prepAI 备课助手教师备课、课程设计、讲义生成9paper-polish科研论文润色与结构检查学术写作、投稿前检查10decision-advisor决策参谋狗头军师方案比选、风险分析、思路碰撞11book-to-skill读书内容转化为知识卡片阅读笔记、拆书、知识库构建12workbuddy任务规划与时间块管理日常待办、项目排期、复盘13cc-switchClaude Code 第三方模型接入切换切换 DeepSeek、Qwen、GLM 等模型14web-search联网搜索增强实时信息查询、资料验证15long-context1M 长上下文管理策略超长代码库、大文档分析16skill-scaffoldSkill 开发脚手架快速生成新技能包模板17code-review-scan代码评审与常见安全扫描Code Review、依赖风险检查这 17 个技能包我按照实际用途分成了三大类开发与工具链类、内容与知识管理类、Claude Code 运行增强类。下面每类挑几个重点展开讲清楚每个技能包内部是怎么组织的、用起来什么体验。2.2 开发与工具链类环境配置不再重复造轮子这一组技能包解决的是每个新环境都要重新折腾一遍的痛点。拿 ros-one-click 来说它内部存了不同 Ubuntu 版本的 ROS 源配置、依赖清单、常见报错对照表你只要告诉它当前系统版本和一个目标版本比如 humble它会按 Skill 里的流程自动选择正确的安装命令而不是每次都在网上现查。实测下来最有用的是它的排错部分装 ROS 最常见的E: Unable to locate package问题Skill 里直接写了换源和清理缓存的完整命令序列省掉大量沟通成本。keil5-install 这个技能包是被群里做嵌入式的朋友催出来的。Keil5 的安装坑主要在组件选择、注册、芯片支持包这三个环节技能包里把每一步该勾什么、不该勾什么拆成了图表式说明Claude 安装时会主动提醒你哪些组件会导致后续编译报错。对新手来说这个技能包等于内置了一个有经验的师傅在旁边盯着。cpp-thirdparty-libs 则是给 C 项目做依赖整合的它内置了常见库的获取方式、版本兼容矩阵和 CMake 集成模板。比如你想在项目里引入 OpenCV 和 EigenSkill 会先检查你的编译器和 CMake 版本再给出对应的 find_package 写法避免那种本机编译好好的换台机器就崩的经典问题。py-version-manager 的思路类似只不过针对的是 Python 多版本切换在 Windows 10 上实测很好用装好之后一句话切换默认 Python 版本不用手动改 PATH。stm32-assistant 和 cangjie-dev 偏垂直领域。前者把 STM32 的工程模板、时钟配置、常用外设初始化代码整理成了速查手册Claude 能直接按你选的型号生成初始化代码骨架后者是配合仓颉语言用的项目初始化、包管理、基础语法示例都在里面对刚上手国产新语言的人来说帮助很大。这两个技能包说明一个道理Skill 的价值不在于功能多花哨而在于把某个领域散落的资料整理成结构化的操作流程。2.3 内容与知识管理类写稿、备课、改论文都有专项技能这组技能包我日常使用频率最高尤其是 de-ai-writer。这个技能包的设计思路非常有意思它不仅要求 Claude 改写文本还会强制检查一批AI 味关键词——包括综上所述总的来说首先其次最后赋能抓手这类高频模板词以及那种三段式论证、每段首句概括的结构模板。改写完成后 Skill 会要求 Claude 自己复查一遍确保没有明显的八股文痕迹。我自己写博客的时候就靠它生成的内容拿去直接发不用再手动剃一遍。lesson-prep 是给老师或者做培训的人准备的技能包里内置了课程标准拆解模板、教学目标设计框架和课堂活动生成规则。你输入一个知识点和年级它会按照导入-讲解-练习-总结的结构生成完整教案并且会刻意避免那种大纲式的干巴巴表达而是加上具体的课堂提问和互动环节。paper-polish 则偏学术内置了期刊常见的风格要求、时态使用规范以及减少被动语态避免重复表述这类润色规则投论文前用它过一遍很省心。decision-advisor 有个更接地气的名字叫狗头军师实际上是一个决策辅助技能。它不给你直接答案而是先引导你把问题拆成目标-约束-选项-风险四个维度然后逐项分析最后给出一个带概率预估的结论。我拿它做过技术选型和方案比选最大的收益不是结论本身而是它逼着你把模糊的想法变成可讨论的条目。book-to-skill 则是我整理知识库的利器把一本书的内容转化成可检索的知识卡片输出格式是固定的 YAML 卡片结构方便后续导入笔记软件。workbuddy 就是任务规划把一整天的待办转成时间块实测配合番茄工作法使用效果最好。2.4 Claude Code 运行增强类模型切换、联网搜索、长上下文管理cc-switch 这个技能包解决了Claude Code 怎么接第三方模型的问题。它把环境变量的切换逻辑写成了标准流程修改ANTHROPIC_BASE_URL和ANTHROPIC_MODEL然后在 DeepSeek、Qwen、GLM 这些兼容接口之间快速切换同时保留官方配置以便切回。技能包里还存了一份配置文件模板包含超时时间、最大 token 等参数避免切换后出现请求异常的尴尬。如果你有本地模型环境比如通过 LM Studio 起的 OpenAI 兼容服务同样可以用这个技能包的逻辑接进去原理是一样的。web-search 是我认为被低估的一个技能包。它的作用不是让 Claude 上网而是规定了什么时候应该搜索、怎么把搜索结果组织进回答。技能包要求 Claude 在给出涉及时效性信息时先搜索同时对搜索到的内容标注来源和可信度避免幻觉。配合 CC Switch 一起用时第三方模型加搜索的组合也能获得接近官方联网体验的准确度。long-context 则面向 1M 长上下文的使用场景它的核心价值在于教你如何分段投喂、如何用摘要压缩早期上下文、如何让 Claude 在长文档中快速定位关键代码实测在分析大型仓库时能明显减少答非所问。skill-scaffold 和 code-review-scan 这两个收尾压轴。skill-scaffold 是给想自己开发 Skill 的人准备的它会在~/.claude/skills/下生成一个标准模板包含正确的SKILL.md格式、示例脚本目录和一条校验命令后面第 6 节我会详细演示。code-review-scan 则把代码审查的检查清单固化了包含未处理错误、硬编码凭据、危险函数调用、依赖版本风险这几类核心项目你只要把改动 diff 丢给它就能输出一份结构化的评审意见。3. 一键安装这份清单是怎么装起来的3.1 先搞清楚安装的本质安装 Skill 说穿了就是两件事把技能包文件夹放进~/.claude/skills/对应的目录里以及确保里面的SKILL.md格式正确。目录结构长这样~/.claude/skills/ ├── ros-one-click/ │ ├── SKILL.md │ ├── scripts/ │ │ └── install_ros.sh │ └── references/ │ └── version_matrix.md ├── cc-switch/ │ ├── SKILL.md │ └── templates/ │ └── env.conf └── ...只要满足这个结构Claude Code 在会话启动时就会自动加载。反过来讲你遇到装完不生效的问题十有八九是目录层级错了或者SKILL.md命名不对因为技能包的加载对路径是大小写敏感的。还有一点要注意装完新 Skill 后建议重开一个会话再测试虽然 Claude 在部分场景下能动态识别但实测下来新会话的触发率明显更稳。一键安装脚本的另一个隐藏好处是把版本管理带上。我自己维护这份清单的仓库里面除了各技能包的源码还有一个install.sh每次更新技能包之后只需要重新跑一遍脚本所有技能就能同步到最新版。这也是我推荐大家用脚本而不是手动拷贝的原因手动方式一次两次还行技能包多了以后必然混乱。3.2 一键安装脚本的完整实现下面是我实际在用的安装脚本核心逻辑是定义技能名和仓库地址的映射逐个git clone到 skills 目录装完删除.git元数据最后输出统计信息。#!/usr/bin/env bash # install_claude_skills.sh # 一键安装/更新 17 个 Claude Code Skill set -uo pipefail SKILL_DIR${HOME}/.claude/skills mkdir -p $SKILL_DIR # 技能名目录名 - 仓库地址 declare -A SKILLS( [ros-one-click]https://github.com/your-org/skill-ros-one-click.git [keil5-install]https://github.com/your-org/skill-keil5-install.git [cpp-thirdparty-libs]https://github.com/your-org/skill-cpp-thirdparty-libs.git [py-version-manager]https://github.com/your-org/skill-py-version-manager.git [stm32-assistant]https://github.com/your-org/skill-stm32-assistant.git [cangjie-dev]https://github.com/your-org/skill-cangjie-dev.git [de-ai-writer]https://github.com/your-org/skill-de-ai-writer.git [lesson-prep]https://github.com/your-org/skill-lesson-prep.git [paper-polish]https://github.com/your-org/skill-paper-polish.git [decision-advisor]https://github.com/your-org/skill-decision-advisor.git [book-to-skill]https://github.com/your-org/skill-book-to-skill.git [workbuddy]https://github.com/your-org/skill-workbuddy.git [cc-switch]https://github.com/your-org/skill-cc-switch.git [web-search]https://github.com/your-org/skill-web-search.git [long-context]https://github.com/your-org/skill-long-context.git [skill-scaffold]https://github.com/your-org/skill-scaffold.git [code-review-scan]https://github.com/your-org/skill-code-review-scan.git ) install_one() { local name$1 local url$2 local target${SKILL_DIR}/${name} if [ -d $target ]; then echo ${name} 已存在执行更新 git -C $target pull --rebase --quiet 2/dev/null || { echo ${name} 更新失败跳过 return 1 } else echo 安装 ${name} git clone --depth 1 $url $target 2/dev/null || { echo ${name} 克隆失败跳过 return 1 } fi # 删除 .git避免 Claude 上下文混入版本管理文件干扰判断 rm -rf $target/.git echo ${name} 就绪 } for name in ${!SKILLS[]}; do install_one $name ${SKILLS[$name]} done echo echo 安装完成当前技能目录总数: $(ls -1 $SKILL_DIR | wc -l) echo 请重开 Claude Code 会话后测试几个关键设计点我得单独说明。第一git clone --depth 1只拉最新提交速度比完整克隆快很多技能包这种小仓库完全够用第二强制删掉.git目录是因为 Claude 在读取技能包目录时如果看到.git容易把版本信息也当作上下文内容读进去干扰判断删掉清爽第三脚本里每个技能是独立安装的即使某个仓库临时不可用也不会中断后面所有的安装。你如果不想自己维护仓库也可以改成从打包好的压缩包安装逻辑类似把git clone换成curl下载然后unzip解压。不过用 git 的好处是后续更新方便重新跑一遍脚本就自动pull了压缩包则每次都要手动重新下载。我个人推荐 git 方式。装完之后的验证方法很简单。先跑ls ~/.claude/skills/看目录结构然后在 Claude Code 里直接问一句你现在有哪些可用的 Skill它会根据已加载的SKILL.md描述汇总给你。如果某个技能没被提到优先检查它的description是否写清楚了这是触发率的最大变量。4. 装完之后必须摸一遍的「调教」步骤4.1 给 Skill 做减法与配置17 个技能包全装上之后第一件事不是急着用而是做减法。因为 Claude 每次对话都会扫描所有 Skill 的描述数量太多会影响触发精准度。我的做法是把暂时不用的技能包移到~/.claude/skills_inactive/目录只留当前项目相关的。比如我在做嵌入式项目时只保留 stm32-assistant、keil5-install、code-review-scan 这几个ros-one-click 和 lesson-prep 先移出去需要时再放回来。另一个容易被忽略的地方是~/.claude/settings.json的权限配置。很多技能包内部会调用脚本命令比如 ros-one-click 要执行sudo apt updatecode-review-scan 要跑依赖扫描工具这都需要 Bash 工具权限。第一次触发时 Claude Code 会弹出权限确认如果你不想每次都点可以在settings.json里给对应技能目录配置允许列表。但我不建议为了省事全放开尤其是带sudo命令的环境配置类技能保持每次确认反而安全。还有一点要注意目录命名。技能包目录名和SKILL.md里的name字段最好一致我的脚本里SKILLS数组的 key 就是这个 name。不一致虽然不一定报错但会导致 Claude 识别混乱实测出现过明明装了好几个技能Claude 只认其中一个的情况最后排查发现就是 name 对不上。4.2 结合第三方模型的注意事项我刚接触这一块时最大的误区是觉得接上第三方模型后 Skill 就不生效了其实不对。Skill 的加载逻辑跟后端是哪个模型没有直接关系只要 Claude Code 本身能连上进行对话Skill 就会被注入。区别在于模型本身的能力上限——同一个 Skill 指令Claude 官方模型和第三方模型执行出来的质量可能有差距特别是 de-ai-writer 这种对语言风格要求很高的技能包。用 CC Switch 切换模型时我建议遵循一个原则功能型技能ros-one-click、stm32-assistant 这类按步骤执行的可以放心在第三方模型上跑因为它们主要依赖结构化指令和脚本创作型技能de-ai-writer、lesson-prep 这类尽量保留在官方模型上风格稳定度明显更好。实测下来 DeepSeek 和 Qwen 在处理代码类任务时表现不错但文学性改写还是差口气。环境变量是另一个坑点。cc-switch 技能包内部管理的ANTHROPIC_BASE_URL和ANTHROPIC_MODEL如果切换后忘了恢复你可能会发现官方模型突然不可用实际是环境变量还指向第三方网关。所以我给 cc-switch 技能包里加了一个当前配置检查的命令每次切换前后都输出当前生效的模型标识从根上避免这种问题。接入 LM Studio 这类本地模型时同理只是地址换成本机的http://127.0.0.1:端口号就行。5. 踩坑实录这些坑我基本都趟过5.1 常见问题速查表问题现象可能原因解决办法技能包装完但不触发SKILL.md的description太模糊重写描述明确当用户提到 XX 时使用以动词开头会话里看不到新装的技能没有重启会话重开 Claude Code 会话再询问技能调用时报权限错误脚本执行需要 Bash 权限在设置中允许对应技能目录或补全 settings.json 权限同名技能被覆盖两个技能包用了同一个name检查目录名和 YAML 的 name 字段保证全局唯一技能包目录中文乱码仓库文件编码或路径问题一律用英文目录名SKILL.md 内文用 UTF-8模型切换后技能行为异常部分技能对模型风格有依赖创作类技能切回官方模型功能类可留第三方脚本中断导致部分技能没装上网络波动或仓库地址失效给脚本加日志输出逐条重试失败的项Claude 读取技能包时输出杂乱技能目录里混入了.git安装后清理.git保持目录干净这张表里的问题我基本都实际遇到过。最典型的还是第一个——描述写得太泛。我第一次给一个代码审查技能写的描述是帮助用户检查代码结果 Claude 十次有八次不调用它后来改成当用户要求进行代码审查、检查 Pull Request、排查潜在 Bug 或安全风险时使用触发率直接拉满。这个经验后来也用到了其它技能包上效果普遍明显。5.2 几个实操中验证过的技巧关于让技能包更听话我分享几个亲测有效的小技巧。第一在SKILL.md正文里除了写步骤一定要写一段什么时候不要用。比如 ros-one-click 里明确写了如果用户系统不是 Ubuntu 或 Debian 分支不要执行本技能这能避免 Claude 在不合适的环境里硬套流程。模型是概率系统给它的边界越清晰行为就越可控。第二把大段参考材料放入references/子目录而不是堆在SKILL.md正文里。技能包加载时会读取主体文件子目录里的材料是按需查的。这样设计能让SKILL.md保持精简Claude 每次触发技能时只读核心指令需要细节再翻引用响应速度和准确率都更高。第三技能包内容要像代码一样做版本管理。我每个技能包都是独立 git 仓库更新时先在本仓库测试再推送然后用第 3 节的脚本一键同步。这样即使某个版本改坏了也能git log回溯到之前的提交而不是靠我记得之前那个版本能用去碰运气。第四一个项目里不要同时挂着功能重叠的技能包。我有段时间同时装了三个不同的代码生成类技能结果 Claude 经常拿不准该用哪个生成的代码风格飘忽不定。后来只保留最适合当前项目的一个问题立刻消失。技能列表宁缺毋滥这个原则我建议每个人都遵守。6. 最后自己写一个 Skill 也不难6.1 最小可用 Skill 的写法看完了清单和安装脚本你大概率会想动手做一个自己的技能包。这事门槛比想象中低一个最小可用版本只需要一个SKILL.md文件。给你看一个实际能用的例子我一个 SQLite 技能的骨架--- name: sqlite-expert description: 帮助用户创建、查询、优化 SQLite 数据库。当用户提到 SQLite、数据库建表、慢查询、.db 文件时使用。 --- # SQLite Expert ## 使用场景 - 分析 SQLite 数据库的表结构和数据 - 编写并优化 SQL 查询 - 处理常见的锁库、损坏、迁移问题 ## 核心操作 - 查看所有表: sqlite3 data.db .tables - 查看表结构: sqlite3 data.db .schema 表名 - 慢查询优化: 先执行 EXPLAIN QUERY PLAN 检查全表扫描再考虑加索引 ## 注意事项 - 修改表结构前必须先备份数据库文件 - 禁止在生产环境直接执行 DROP TABLE 类操作 - 查询结果较大时建议使用 LIMIT 限制行数后逐步分析这个文件最重要的部分是 YAML 头里的name和descriptionname必须和目录名保持一致description要写清触发条件。正文则是给 Claude 的操作手册关键是具体——不要写帮助用户管理数据库这种空话而是直接写命令、写判断逻辑、写注意事项。装好后测试一下如果感觉触发不够灵敏九成问题出在description上。多观察 Claude 的反应反复迭代这个字段等它能在你需要的场景稳定触发这个技能就算做成了。6.2 发布与维护的几条经验技能包做出来之后我建议你走一遍先用再传的流程。先在自己常用项目里用两周把所有不符合预期的场景记录下来改完SKILL.md再考虑要不要发布到 GitHub。发布时记得写一个清晰的 README里面放一张功能截图和安装命令别人看到能一眼明白它在什么场景下能帮我省时间比写一堆技术细节有用得多。维护节奏上我的习惯是一个月做一次整体 review重点检查两件事一是description是否需要补充新的触发词因为随着项目变化你可能会发现新的应用场景二是正文里的命令和链接有没有过时工具版本更新后之前写的安装命令可能就失效了。Skill 和代码一样不维护就会腐烂。最后再分享一个扩展方向这 17 个技能包完全可以当成自己的团队标准来看待。如果你跟同事协作或者带团队把这些技能包放进公共仓库新人入职跑一次安装脚本就自动获得了团队积累的安装流程、代码规范、避坑经验——这才是 Skill 机制最有价值的地方。我也是从这个角度出发维护这份清单的后续大概率还会持续加新的技能包进去到时候再单独写文分享。