;的关键词。好的写法："按公司格式整理每周工作周报。当用户说写周报、周总结、整理本周工作、汇报这周进展时使用。"它把功能和触发场景都说全了，还铺了好几个用户可能用的说法当关键词。写description的诀窍就一条：把用户可能怎么开口，尽量都塞进去。
3.4 第三步：写正文步骤，附上样板

正文就是上面那段三道横线下面的内容。写法很直白，先一句话说清这个Skill干什么，再用编号把步骤列清楚，最后给一个填好的样板。
样板这一步别省。AI看一个具体的好例子，比读三行抽象描述学得快得多。周报Skill里那段"本周完成：完成X模块联调（张三）"，就是给AI看的标准答案，它会照着这个样子输出。能给例子的地方都给例子，这是让Skill稳定的最便宜的办法。
3.5 第四步：长了就拆，加一个 references 文件

如果你的格式规矩很多，正文眼看要超过500行，就该拆了。做法是在文件夹里建一个references子目录，把详细规矩挪进去，比如建一个references/format-rules.md，里面写满各种边角情况：节假日那周怎么写、跨部门项目负责人怎么标、数字精确到几位。
然后在正文里留一句话指路："详细的格式规范见references/format-rules.md。"这样AI平时只读精简的正文，真碰到复杂情况才去翻那份细则。正文保持清爽，细节又不丢，这就是渐进式披露在你自己Skill里的用法。
3.6 第五步：确定的活写成 script

到这里Skill还只是"会自动翻出来的prompt"。要用上它真正的杀手锏，就把确定性的活儿写成脚本。
举个周报里就有的例子。结尾那个三列表格，如果数据来自一个Excel，让AI一格一格读、一格一格算总和，又慢又可能错。正确做法是在scripts里放一个小程序，比如scripts/make_table.py，让它读Excel、自动算好每列的合计、生成表格。AI只负责运行这个脚本，确定的答案直接出来。
再看官方那个更典型的。Anthropic的PDF技能里有段Python程序专门抽PDF表单字段，AI直接运行就拿到结果，不用把整个PDF读进脑子。凡是排序、求和、格式转换、批量改名这类有标准答案的活，都交给脚本，比让AI一个字一个字生成又快又准。这一步需要一点点编程，但零基础阶段可以先跳过，等周报Skill跑顺了再回来加。
3.7 第六步：自检

做完跑之前，对着几条硬规矩自检一遍。文件夹名和SKILL.md里的name是否一致。name是否只用了小写字母、数字、连字符，有没有不小心写成大写或带空格。description有没有把"什么时候用"说清楚。正文是否在500行以内。引用的文件路径是不是相对路径、是不是只放了一层。
如果你想更省心，开放标准官方提供了一个校验小工具，在github的agentskills/agentskills仓库里，跑一句 skills-ref validate ./weekly-report 就能帮你检查格式对不对。零基础阶段不用它也行，肉眼对着上面几条过一遍就够。
3.8 第七步：实际跑通，认识几个常见坑

做完先让AI实际用一次，别急着收工。你说一句该触发它的话，看它有没有照着你的步骤来。多数人第一次都会卡在几个固定的坑上，提前认识一下能省很多排查时间。
最常见的是它压根没被触发，你说了该用的话它却自顾自地答。十有八九是description没写好，回3.3节，把用户可能的说法多塞几个进去。在Claude Code里可以直接问"有哪些skill可用"，确认它到底有没有被加载进来。
第二个坑是name和文件夹名对不上，或者name里混进了大写字母、空格、下划线。规矩很死，只能小写字母、数字、连字符，且必须跟文件夹同名，错一个字符就可能加载失败。
第三个坑只在claude.ai出现，上传后死活用不了，往往是代码执行没开。回4.1节先确认那个开关。还有一个高频小错是打包，zip解开后不能多套一层，里面第一层必须直接是你那个Skill文件夹。
第四个坑跟脚本有关，脚本跑不起来。先看运行环境，Claude Code能联网、能用本机的包，但API的容器不能联网、不能临时装包，你的脚本如果依赖某个没预装的库，在API那边就会失败。
最后一个偏经验：description写得太泛会"误触发"。比如你写"整理文档"，结果用户一提到任何文档它都跳出来抢活。触发场景写得具体一点、贴着真实用法，比写得宽泛安全。
3.9 再做一个：代码审查 Skill

举一反三，照同样的套路再做一个，你就彻底会了。这次做代码审查，针对前面1.1节那个"每次都要叮嘱检查空指针、没关的文件、硬编码密码"的痛点。文件夹叫code-review，SKILL.md这么写：
--- name: code-review
description: 按团队清单审查一段代码，检查常见隐患。当用户说"审一下代码""code review""检查这段代码"时使用。
---
# 代码审查
按下面的清单逐项检查用户给的代码，列出问题和改法。
## 检查清单
1. 空指针：有没有可能为空的变量直接被使用。
2. 资源：打开的文件、连接有没有确保关闭。
3. 密钥：有没有把密码、token硬编码在代码里。
4. 错误处理：异常有没有被吞掉而不报。
## 输出格式
每发现一处，写成"位置 + 问题 + 建议改法"三段，没问题就明确说通过。
跟周报Skill一模一样的骨架：两个必填字段，一段带触发词的description，一份编号清单当正文，再加一句输出格式的约定。以后你说"审一下这段代码"，这四条规矩它自己就调出来逐项过，你再不用每次背一遍。换任何一件你反复做的事，套路都是这个。

四、把 Skill 装进 Claude 用

Skill做好了，怎么让Claude真的用上？Claude有三个入口，网页和桌面端、命令行工具Claude Code、面向开发者的API。每个的装法不一样，下面一个一个写清楚。


4.1 在Claude.ai网页或桌面端

普通用户最常用这个，套餐从免费到企业版都支持，但有个前提开关得先打开。
先开代码执行。免费、Pro、Max用户进设置里的Capabilities，确认"Code execution and file creation"（代码执行与文件创建）是打开的。团队和企业版要由管理员在组织设置里先开。为什么要先开这个，因为Skill跑起来依赖代码执行的能力。
再打开Skills。代码执行开了之后，在左边栏找到Customize下的Skills（有些较旧的文档里这个入口叫Settings下的Features，指的是同一处，以你登录后实际看到的为准）。进去能看到四个内置技能，PowerPoint、Excel、Word、PDF，逐个打开就能用。
上传你自己的Skill。在Skills界面点加号，再点"Create skill"，上传一个zip压缩包。注意压缩包的结构，zip解开后第一层必须就是你那个Skill文件夹，别多套一层。也就是把weekly-report这个文件夹直接压成weekly-report.zip。个人用户上传的自定义Skill默认归个人使用。Team和Enterprise还可以由管理员在组织层面统一配置或下发Skill。
怎么触发。代码执行开着的时候，Claude会在合适的时候自动调用，不用你专门下命令。你说"做一个Q3业绩的PPT"，它自动用上pptx技能。你说"整理本周周报"，它自动翻出你那个weekly-report。
还有一条不用自己写、直接拿来用的路子。Skills界面里点加号有个"Browse skills"，那是一个把技能、连接器、插件合在一起的目录，里面有官方和合作伙伴做好的现成技能，看中哪个点"Install"就装上，装完默认就启用。自己懒得写、或