第一个 Skill 别贪大,一个 SKILL.md 就能跑起来
每周一早上九点,打开关键词工具,采集搜索量,分析竞争度,筛长尾词,整理成文档发群里。这活儿我干过整整一个季度,每次两个多小时,没有一周漏掉,也没有一周觉得新鲜。
后来我把这套流程写成一个 SKILL.md 文件,二十几行,交给 Claude Code。现在周一早上我在喝咖啡,报告自己在 runs 目录里躺着。
这不是什么高深技术。Skill 就是给 Claude Code 的一份标准作业流程,最小形态只有一个 SKILL.md,用大白话写清楚目标、步骤和约束。真正拦住大多数人的,是从「装了几个现成的」到「自己写、自己调、自己串成流水线」这一段路。这篇就把这段路拆开讲,每一步都给能直接抄的做法。
学 Skill 第一步不是写,是装。跟学编程一个道理,先跑通别人的代码,搞清楚输入是什么输出是什么,再动手写自己的。
麻烦在于 Skill 目前没有统一的应用商店,官方注册表、GitHub 仓库、各家博客,来源散,质量也参差,你不知道装哪个,也不知道装了会不会跟自己的环境打架。省力的做法是先用搜索器把候选捞一遍,从 CLI 注册表、网络、GitHub 三个渠道搜,自动去重,拿一份对比报告再决定装哪个。
装完别光顾着爽,重点看三样东西。
一看它的 SKILL.md 怎么写的,描述了什么目标,列了哪些步骤,设了什么约束。二看目录结构,有没有 scripts、config、runs 这些子目录,各自放了什么。三看执行效果,输出稳不稳定,边界情况兜不兜得住。
这三样看完,你对 Skill 的基本认知就有了,比读十篇教程都管用。
SKILL.md 就是一份交接文档
想象你要休个长假,得把一个日常任务交接给新同事。你会写份文档,说清楚要做成什么,什么时候做,按什么步骤做,哪些坑不能踩。SKILL.md 就是这么个东西,四个部分。
# Skill 名称
## 目标 一句话说清这个 Skill 干什么
## 触发条件 什么时候该调用它
## 执行步骤 1、2、3 一步步列出来
## 约束条件 不能做什么,异常怎么处理
给个真实可跑的迷你例子,一个站点健康检查 Skill,就十几行。目标写检查指定网站是否可访问,返回状态码和响应时间。触发条件写用户说「检查一下网站」或 /site-check。执行步骤四步,从 config/sites.txt 读 URL 列表,逐个 curl 记录状态码和响应时间,非 200 的标异常,报告输出到 runs 目录。约束条件写清楚超时阈值 10 秒,超时记异常但不中断,只查可访问性不做内容抓取,最多查 50 个 URL 超出截断。
复制过去改一改,就是你的第一个 Skill。
复杂一点要上脚本的时候,分工有一条铁律。确定性任务交脚本,判断类任务交 Agent。API 调用、文件处理、格式转换这类活,输入输出都是确定的,脚本跑起来稳定还省上下文。理解需求、生成内容、评估质量这种要动脑子的,才轮到 Agent。别反过来用,让 Agent 做脚本的活既浪费又不稳,让脚本做 Agent 的活根本写不出来。
确定性的活交给脚本,要动脑子的活交给 Agent,这条线划不清,Skill 就做不稳。
目录结构从一个 SKILL.md 开始就行。等真遇到需要脚本的场景再加 scripts,需要复盘运行状态再加 runs。按需创建,别过度设计。老雷的建议是,第一个 Skill 就挑一个流程最简单、每周重复三次以上的任务,先跑起来,再迭代。
七个跑通的案例,看的都是分工
理论到此为止,看案例。下面这七个都是别人真实跑通的项目,实测数据都在,重点不是有多酷,是每一条里「哪些给了脚本、哪些给了 Agent」。
先说最小的。书签整理,几百个积攒多年的书签,导出、清死链、按主题分类、去重、出报告,实测全程不到十分钟。这种小到不想手动做、大到手动做不完的任务,是 Skill 的甜点。
往上一步,Reddit 素材研究。写文章要真实案例和用户观点,手动翻一个选题得几个小时,在不同版块之间跳来跳去。Skill 按关键词搜多个版块,提取高赞回答,按主题分类,实测几分钟出一包能直接用的素材。
再往上,爆款内容拆解。人工拆一篇至少半小时,还容易只盯自己熟悉的维度,做标题的只看标题,排版的只研究格式。Skill 从标题吸引力、内容结构、选题角度、情绪触发点、评论区反馈五个维度出量化评估,给的是可借鉴的具体手法,不是一句「这篇写得好」。
分工最典型的是股票分析。脚本从接口拉实时行情,脚本算均线、MACD、RSI 这些指标,Agent 综合信号判断趋势方向,Agent 生成分析报告。前两步是确定计算所以给脚本,后两步要推理所以给 Agent,一条流水线四种活,边界干干净净。
专业领域的代表是法律知识库。律师助理的日常是半天半天耗在检索上,几万条法条和司法解释里翻条文、交叉比对判例。这个 Skill 不替律师做判断,只把机械检索自动化,法条、司法解释、典型案例建成结构化知识库,输入「劳动合同解除的赔偿标准」,直接返回相关条文和典型判例。
第七个之前先插一个平台组合的。SEO 关键词周报,每周都做、流程完全固定但执行枯燥,交给 n8n 定时触发加数据流转,Skill 管关键词分析和内容建议。平台管确定性的调度,Skill 管需要语义理解的环节,各司其职。
压轴的这个,自动修 Bug。前面六个都是 Skill 替你干活,这个是 Skill 自己维护自己。n8n 监听运行日志,检测到报错自动触发修复流水线,分析错误类型,判断能不能自动修,执行修复,重跑验证,验证不过才升级人工。从工具到自我维护,这是 Skill 工程化的天花板了。
老雷帮企业排自动化方案的时候,第一句话永远是先问,你的活儿里哪些是每个周期固定重复的。回到你自己的工作,三个问题筛一遍。每周重复三次以上的任务有哪些,这些任务里哪些步骤是确定的哪些要判断,做完的输出格式是固定的吗。格式越固定,Skill 越好写。

调试三层,顶层是让它自己修
写完只是开始。Skill 的调试跟普通代码不一样,普通代码同样的输入必出同样的错,Skill 带 Agent 判断,同样的输入可能跑出不同的结果,定位起来更磨人。
有效的做法分三层。
第一层,日志先行。在关键步骤把输入、输出和中间状态写进 runs 目录。一个数据分析 Skill 应该记下原始数据拿到多少条、清洗后剩多少条、关键指标是什么。出了问题,你能精确指认是哪一步出的错,而不是对着一个错误结果干瞪眼。
第二层,脚本和 Agent 分开排查。脚本的问题用老办法,单元测试、边界输入,确定性的都能重现。Agent 行为飘了先别急着改代码,查三件事。SKILL.md 的描述够不够明确,模糊指令是行为飘忽的头号原因。约束条件覆没覆盖出错的场景,很多时候不是 Agent 做错了,是你压根没告诉它不能做什么。上下文是不是过载了,SKILL.md 引用文件太多,Agent 也会看花眼做出意外判断。
第三层,让它自己修。修 Bug 这件事本身也可以做成可重复的流程,监听状态文件或退出码检测报错,自动分析错误类型,按类型选修复策略,重试、降级、跳过还是升级人工,修复完重跑验证,失败就留存现场数据通知人。每修一次,把这次的边界条件写回 SKILL.md 的约束里,下次就不再栽同一个坑。
别问老雷是怎么知道的,约束条件库就是一次次翻车换来的。

串流水线,接口比技术难
一个 Skill 解决一个问题,真实业务是一串问题。采集素材、分析选题、生成初稿、质量评审、格式转换、发布,每个环节一个独立 Skill,串起来就是一条自动化流水线。
串联难的不是技术,是三个设计决策。
接口契约,上一个 Skill 的输出格式必须和下一个的输入对上,最省事的做法是统一用 JSON 或 Markdown 文件中转,A 把结果写到 output.json,B 从这个文件读,格式约定写进各自的 SKILL.md,改了输出就同步改下游的说明。
状态管理,每次运行完要有明确标记,成功、失败还是部分完成,流水线靠状态决定继续、回退还是跳过。没有状态管理,一个环节出错整条线趴窝,还查不出断在哪。
数据血缘,每份输出从哪来、经过什么处理,要有统一的存放规则,输入输出中间状态都落在同一个 run 目录里,按时间戳或运行编号组织,出了问题能顺着链条追到源头。
像搭乐高,接口对得上才搭得稳。状态管理让你知道搭到哪一步了,数据血缘让你能拆回去重搭。
五个坑和一张勾得掉的清单
栽跟头的姿势翻来覆去就五种。一上来就追求复杂,第一个 Skill 就想接数据库带多步骤,结果没跑通就放弃。把所有事都丢给 Agent,精确计算和稳定执行是脚本的活,交给它必翻车。不写约束条件,只写做什么不写不能做什么,边界一碰就出幺蛾子。不复盘 runs 目录,那里的运行数据是优化 Skill 的金矿,每次跑完花几分钟看看,常能发现流程设计的盲区。闭门造车,不拆几个现成的就自己硬写,效率差一大截。
对照这张清单走,每完成一项勾一项。
体验阶段,半天。装一个现成 Skill 完整跑一遍,读懂它的 SKILL.md。
动手阶段,一天。找出每周重复三次以上的任务,按四部分结构写出 SKILL.md,运行观察,至少迭代两轮。
进阶阶段,一到两周。加上日志和自修复,把两个以上 Skill 串成流水线,按工程化标准重构一遍。
体系化阶段,长期。接 n8n 做定时调度,让 Skill 变成可交付的资产。
顺手说一句 Skill 的去处。窄场景可以直接卖工具,通用能力拿去交付服务,开发过程能沉淀成课程,或者开源攒影响力再接咨询。门槛最低的是第二条,客户买的不是你的 Skill,是分析报告和优化建议,你只要自己用着顺手,就够开工了。
把一次性的活儿变成可复用的资产,Skill 全部的价值都在这一句里。
第一次写 SKILL.md 的时间,可能比直接干还慢。第二次你省掉了描述需求的时间。第十次以后,你已经忘了这件事曾经需要手动做。
这周就找一个重复三次以上的任务,用四部分结构把它写出来,跑一次看看。资产都是从第一次开始攒的。
