Agent Skills 实战指南从模板到自建技能【免费下载链接】skillsPublic repository for Agent Skills项目地址: https://gitcode.com/GitHub_Trending/skills3/skills每次让 AI 生成文档都要重新交代一遍公司的排版规范和导出要求把这些规则写进一个技能文件夹Claude 以后会在合适的时机自己加载它们。这份仓库Anthropic 官方的 Agent Skills 集合把这件事做成了标准形态每个技能是一个带SKILL.md的文件夹靠渐进式披露控制上下文开销可以直接装进 Claude Code也可以照着模板写出你自己的技能。重复喂规则把流程固化进技能文件夹技能长什么样一个文件夹加一个 SKILL.md技能不是插件、不是 pip 包就是一个目录。最小结构只有一个文件my-skill/ └── SKILL.mdSKILL.md由 YAML frontmatter 和 Markdown 正文两部分组成前者告诉 Claude 这个技能叫什么、什么时候该用后者是触发后执行的指令。仓库里的template/SKILL.md就是这个最小形态spec/目录则指向 Agent Skills 规范。仓库里现成的四类技能skills/目录下可以直接抄作业大致分四类文档类skills/docx、skills/pdf、skills/pptx、skills/xlsx——驱动 Claude 文档能力的生产级实现是学习复杂技能组织方式的最佳样本创意类skills/canvas-design海报/视觉设计、skills/frontend-designUI 设计方向、skills/brand-guidelines、skills/theme-factory、skills/slack-gif-creator开发类skills/mcp-builder写 MCP 服务器的完整方法论、skills/webapp-testing企业协作类skills/internal-comms含新闻稿、FAQ 等范文、skills/doc-coauthoring三层渐进式披露控制上下文开销元数据层常驻的约百词技能再多也不怕上下文爆炸因为加载是分层的。第一层只有name和description两项元数据常驻上下文约百词。这就是为什么 description 是技能最重要的字段——它决定了 Claude 在几十上百个技能里能不能准确挑中你。正文层500 行是软上限第二层是SKILL.md正文技能触发时才进上下文。仓库的惯例是控制在 500 行以内逼近上限就再拆一层在正文里写明什么时候去读哪个文件。超过 300 行的大参考文件自己加个目录索引。资源层scripts 与 references 按需加载第三层是随技能打包的资源目录约定如下skill-name/ ├── SKILL.md ├── scripts/ # 可执行代码跑完即弃不必读进上下文 ├── references/ # 按需加载的文档 └── assets/ # 输出用的模板、字体等支撑多个变体时按变体拆文件例如references/aws.md、references/gcp.mdClaude 只读相关的那一份。在 Claude Code 里装好现成技能注册 marketplace 并安装插件在 Claude Code 中把本仓库注册为插件 marketplace然后按需安装git clone https://gitcode.com/GitHub_Trending/skills3/skills /plugin marketplace add anthropics/skills /plugin install document-skillsanthropic-agent-skills /plugin install example-skillsanthropic-agent-skills两个插件分别对应文档技能包和示例技能包装哪个取决于你日常处理的是 Word/PDF 还是设计、协作类任务。使用时只提一句安装后不需要任何额外配置在对话里点名即可用 PDF skill 把report.pdf里的表单字段提取出来Claude 会加载对应技能并按SKILL.md里的流程执行。付费版 Claude.ai 和 Claude API 也内置了这批技能上传自定义技能的流程在各端入口一致。 用模板写出第一个技能frontmatter 只有两个必填字段把template/SKILL.md拷出来改名填好这两个字段就是一个合法技能--- name: my-skill-name description: A clear description of what this skill does and when to use it --- # My Skill Name [Add your instructions here]name用小写加连字符全局唯一。description 要写得敢触发skills/skill-creator/SKILL.md里给了一个关键提醒Claude 目前倾向于欠触发——该用技能时不用。对策是把 description 写得稍微强势一点同时说清做什么和什么时候用。对比仓库里的两个真实写法skills/pdf/SKILL.mdIf the user mentions a .pdf file or asks to produce one, use this skill.——把触发条件写成祈使指令skills/docx/SKILL.md把 report、memo、letter 等可能出现在用户嘴里的词全部列进触发清单并明确排除边界Do NOT use for PDFs, spreadsheets正文祈使句加按任务拆节正文用祈使句写指令按任务而非按概念分节。skills/pdf/SKILL.md的开头就按合并/拆分/抽取/填表分节每节给出最短可运行的代码进阶内容指向reference.md填表流程单独放进forms.md——这正是第二层拆到第三层的标准示范。从 docx 看复杂技能的组织方式SKILL.md 放决策表脏活交给 scriptsskills/docx/SKILL.md开头就是一张任务-方案对照表新建用 docx-js 脚本编辑已有文件走 unzip → 改word/document.xml→ zip读取用pandoc -t markdown。模型一触发技能就能选对路线不会被长篇解释淹没。真正的工作由skills/docx/scripts/下的脚本承担accept_changes.py处理修订、comment.py插入批注、office/validators/里是整套 XML 校验器。脚本可以执行而无需读进上下文这就是资源层的价值。把踩坑点写成 gotchas这个技能最值得学的是gotchas一节——模型知道 API但不知道坑- 页面默认 A4US Letter 要显式设 12240x15840 (DXA) - 表格要双重宽度table 和 cell 都设 DXA 宽度 - 底纹用 ShadingType.CLEARSOLID 会渲染成黑色 - ImageRun 必须带 type: (png / jpg)写完还要验证产出。skills/docx/SKILL.md给出的流程是转成 PDF 再转成图片自己看python scripts/office/soffice.py --headless --convert-to pdf output.docx pdftoppm -jpeg -r 100 output.pdf pageskills/pdf、skills/pptx、skills/xlsx都带同样的校验脚本结构四者可以互相参照。✅ 用 skill-creator 打磨与评估先跑测试提示词再看量化指标skills/skill-creator是写技能的技能它定义了一条迭代回路写草稿 → 准备几条测试提示词 → 带着技能跑一遍 → 用eval-viewer/generate_review.py生成结果评审页 → 根据定性反馈和量化指标改写 → 重复直到满意再扩大测试集。配套脚本在skills/skill-creator/scripts/下run_eval.py跑单条评估aggregate_benchmark.py做带方差分析的基准聚合improve_description.py专门优化 description 的触发准确率。按技能类型决定要不要测试它的建议很务实输出可客观验证的技能文件转换、数据抽取、代码生成值得建测试用例输出偏主观的文风、设计不必强求量化评估先跑几条提示词人工看效果即可。交付前的检查清单description 写清触发时机正文控制在 500 行内大文件已拆分并加指引重复操作沉到 scripts踩坑点写成 gotchas用测试提示词验证过与既有技能无触发冲突现在就 clone 仓库打开template/SKILL.md挑一个你每周都要重复交代规则的流程把它写进第一个技能——写完装进 Claude Code下一句重复的指令就是你省下的人。【免费下载链接】skillsPublic repository for Agent Skills项目地址: https://gitcode.com/GitHub_Trending/skills3/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Agent Skills 实战指南：从模板到自建技能
Agent Skills 实战指南从模板到自建技能【免费下载链接】skillsPublic repository for Agent Skills项目地址: https://gitcode.com/GitHub_Trending/skills3/skills每次让 AI 生成文档都要重新交代一遍公司的排版规范和导出要求把这些规则写进一个技能文件夹Claude 以后会在合适的时机自己加载它们。这份仓库Anthropic 官方的 Agent Skills 集合把这件事做成了标准形态每个技能是一个带SKILL.md的文件夹靠渐进式披露控制上下文开销可以直接装进 Claude Code也可以照着模板写出你自己的技能。重复喂规则把流程固化进技能文件夹技能长什么样一个文件夹加一个 SKILL.md技能不是插件、不是 pip 包就是一个目录。最小结构只有一个文件my-skill/ └── SKILL.mdSKILL.md由 YAML frontmatter 和 Markdown 正文两部分组成前者告诉 Claude 这个技能叫什么、什么时候该用后者是触发后执行的指令。仓库里的template/SKILL.md就是这个最小形态spec/目录则指向 Agent Skills 规范。仓库里现成的四类技能skills/目录下可以直接抄作业大致分四类文档类skills/docx、skills/pdf、skills/pptx、skills/xlsx——驱动 Claude 文档能力的生产级实现是学习复杂技能组织方式的最佳样本创意类skills/canvas-design海报/视觉设计、skills/frontend-designUI 设计方向、skills/brand-guidelines、skills/theme-factory、skills/slack-gif-creator开发类skills/mcp-builder写 MCP 服务器的完整方法论、skills/webapp-testing企业协作类skills/internal-comms含新闻稿、FAQ 等范文、skills/doc-coauthoring三层渐进式披露控制上下文开销元数据层常驻的约百词技能再多也不怕上下文爆炸因为加载是分层的。第一层只有name和description两项元数据常驻上下文约百词。这就是为什么 description 是技能最重要的字段——它决定了 Claude 在几十上百个技能里能不能准确挑中你。正文层500 行是软上限第二层是SKILL.md正文技能触发时才进上下文。仓库的惯例是控制在 500 行以内逼近上限就再拆一层在正文里写明什么时候去读哪个文件。超过 300 行的大参考文件自己加个目录索引。资源层scripts 与 references 按需加载第三层是随技能打包的资源目录约定如下skill-name/ ├── SKILL.md ├── scripts/ # 可执行代码跑完即弃不必读进上下文 ├── references/ # 按需加载的文档 └── assets/ # 输出用的模板、字体等支撑多个变体时按变体拆文件例如references/aws.md、references/gcp.mdClaude 只读相关的那一份。在 Claude Code 里装好现成技能注册 marketplace 并安装插件在 Claude Code 中把本仓库注册为插件 marketplace然后按需安装git clone https://gitcode.com/GitHub_Trending/skills3/skills /plugin marketplace add anthropics/skills /plugin install document-skillsanthropic-agent-skills /plugin install example-skillsanthropic-agent-skills两个插件分别对应文档技能包和示例技能包装哪个取决于你日常处理的是 Word/PDF 还是设计、协作类任务。使用时只提一句安装后不需要任何额外配置在对话里点名即可用 PDF skill 把report.pdf里的表单字段提取出来Claude 会加载对应技能并按SKILL.md里的流程执行。付费版 Claude.ai 和 Claude API 也内置了这批技能上传自定义技能的流程在各端入口一致。 用模板写出第一个技能frontmatter 只有两个必填字段把template/SKILL.md拷出来改名填好这两个字段就是一个合法技能--- name: my-skill-name description: A clear description of what this skill does and when to use it --- # My Skill Name [Add your instructions here]name用小写加连字符全局唯一。description 要写得敢触发skills/skill-creator/SKILL.md里给了一个关键提醒Claude 目前倾向于欠触发——该用技能时不用。对策是把 description 写得稍微强势一点同时说清做什么和什么时候用。对比仓库里的两个真实写法skills/pdf/SKILL.mdIf the user mentions a .pdf file or asks to produce one, use this skill.——把触发条件写成祈使指令skills/docx/SKILL.md把 report、memo、letter 等可能出现在用户嘴里的词全部列进触发清单并明确排除边界Do NOT use for PDFs, spreadsheets正文祈使句加按任务拆节正文用祈使句写指令按任务而非按概念分节。skills/pdf/SKILL.md的开头就按合并/拆分/抽取/填表分节每节给出最短可运行的代码进阶内容指向reference.md填表流程单独放进forms.md——这正是第二层拆到第三层的标准示范。从 docx 看复杂技能的组织方式SKILL.md 放决策表脏活交给 scriptsskills/docx/SKILL.md开头就是一张任务-方案对照表新建用 docx-js 脚本编辑已有文件走 unzip → 改word/document.xml→ zip读取用pandoc -t markdown。模型一触发技能就能选对路线不会被长篇解释淹没。真正的工作由skills/docx/scripts/下的脚本承担accept_changes.py处理修订、comment.py插入批注、office/validators/里是整套 XML 校验器。脚本可以执行而无需读进上下文这就是资源层的价值。把踩坑点写成 gotchas这个技能最值得学的是gotchas一节——模型知道 API但不知道坑- 页面默认 A4US Letter 要显式设 12240x15840 (DXA) - 表格要双重宽度table 和 cell 都设 DXA 宽度 - 底纹用 ShadingType.CLEARSOLID 会渲染成黑色 - ImageRun 必须带 type: (png / jpg)写完还要验证产出。skills/docx/SKILL.md给出的流程是转成 PDF 再转成图片自己看python scripts/office/soffice.py --headless --convert-to pdf output.docx pdftoppm -jpeg -r 100 output.pdf pageskills/pdf、skills/pptx、skills/xlsx都带同样的校验脚本结构四者可以互相参照。✅ 用 skill-creator 打磨与评估先跑测试提示词再看量化指标skills/skill-creator是写技能的技能它定义了一条迭代回路写草稿 → 准备几条测试提示词 → 带着技能跑一遍 → 用eval-viewer/generate_review.py生成结果评审页 → 根据定性反馈和量化指标改写 → 重复直到满意再扩大测试集。配套脚本在skills/skill-creator/scripts/下run_eval.py跑单条评估aggregate_benchmark.py做带方差分析的基准聚合improve_description.py专门优化 description 的触发准确率。按技能类型决定要不要测试它的建议很务实输出可客观验证的技能文件转换、数据抽取、代码生成值得建测试用例输出偏主观的文风、设计不必强求量化评估先跑几条提示词人工看效果即可。交付前的检查清单description 写清触发时机正文控制在 500 行内大文件已拆分并加指引重复操作沉到 scripts踩坑点写成 gotchas用测试提示词验证过与既有技能无触发冲突现在就 clone 仓库打开template/SKILL.md挑一个你每周都要重复交代规则的流程把它写进第一个技能——写完装进 Claude Code下一句重复的指令就是你省下的人。【免费下载链接】skillsPublic repository for Agent Skills项目地址: https://gitcode.com/GitHub_Trending/skills3/skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考