10 分钟 Claude 技能系统零基础上手:安装、使用到自制一个 AI 技能
【免费下载链接】skillsPublic repository for Agent Skills项目地址: https://gitcode.com/GitHub_Trending/skills3/skills
上周,同事甩来一份客户合同 PDF,让我把里面的表单字段全部提取出来整理成表格。我直接丢给 Claude,得到的只是一通关于"PDF 结构很复杂"的泛泛而谈——直到我装上了 GitHub_Trending/skills3/skills 这个仓库里的 Claude 技能(AI 技能系统)。这个仓库是 Anthropic 公开的官方技能库,每个技能就是一个自包含的文件夹,给 Claude 塞上一份可重复执行的"工作手册"。下面按真实使用流程讲:它是什么、三步装好、能接哪些活、怎么写一个自己的技能,以及动手前的几个避坑建议。
为什么装了技能 Claude 才"干活":30 秒看懂 AI 技能
这一节帮你回答"技能到底是个什么东西,凭什么能改变 Claude 的表现"。
你可以把技能理解成给新员工发的手册:不是替它干活,而是告诉它"遇到这类任务,按这套步骤、用这几个脚本、参考这几份资料来"。一个技能就是一个独立文件夹,核心是SKILL.md——开头用 YAML 写两行元数据(name和description,后者决定 Claude 什么时候想起这个技能),正文是具体指令;旁边可以放scripts/(可执行脚本)、references/(参考资料)、assets/(模板等输出资源)。
关键在于"动态加载":Claude 平时只记住每个技能的元数据(约 100 词),真正被触发时才读完整指令,需要时才翻参考资料。上下文开销很小,所以可以放心多装几个。回到开头的场景:装好文档技能后,你直接对它说"使用 PDF 技能从path/to/some-file.pdf中提取表单字段",它就不会再跟你空谈,而是按手册跑脚本、给你结果。
Claude 技能安装教程:3 个命令装齐文档全家桶
这一节帮你把环境搭起来,装完即可用。
如果你用 Claude Code,全程只需要三步:
第一步,克隆仓库:
git clone https://gitcode.com/GitHub_Trending/skills3/skills第二步,在 Claude Code 里注册这个插件市场:
/plugin marketplace add anthropics/skills第三步,选Browse and install plugins→anthropic-agent-skills,然后二选一:
- document-skills:docx、pdf、pptx、xlsx 四个文档技能,就是驱动 Claude 文档能力的同一套实现,实用度最高
- example-skills:创意、开发、企业沟通类的示例技能,适合找灵感和当参考
也可以跳过菜单直接装:
/plugin install document-skills@anthropic-agent-skills如果你不用 Claude Code:Claude.ai 付费用户可以直接使用这些技能或上传自己的技能;走 Claude API 的,Anthropic 提供预置技能接口,也支持上传自定义技能。三个入口都通。
文档技能选型对照:docx、pptx、pdf 各管什么活
这一节帮你判断"我的任务该丢给哪个技能",避免装了一堆却用错。
| 技能 | 擅长的事 | 典型指令示例 |
|---|---|---|
| docx | 新建/编辑 Word 文档,处理修订(tracked changes)、批注,保留原有格式 | "把这份 Markdown 整理成带目录和页眉的 Word 报告" |
| pptx | 新建/编辑演示文稿,调整版式,写演讲者备注 | "把这份会议纪要做成 10 页的 PPT" |
| 提取文本和表格、合并拆分文档、填写 PDF 表单 | "提取这份合同里所有表单字段" | |
| xlsx | 电子表格的读写与分析 | "按部门汇总这张表的费用并生成透视表" |
装完 document-skills,日常办公的"文档最后一公里"基本都覆盖了。
仓库里其余技能按方向分成三类,装 example-skills 后都能看到:
- 创意与设计:algorithmic-art(代码生成艺术)、canvas-design(海报级画布设计)、theme-factory(十套现成设计主题)、slack-gif-creator
- 开发与工程:webapp-testing(网页自动化测试)、mcp-builder(写 MCP 服务器)、web-artifacts-builder、frontend-design
- 企业沟通:brand-guidelines(品牌规范落地到文档和 PPT)、internal-comms(内部通告、新闻稿、FAQ)、doc-coauthoring(协作写文档)
SKILL.md 怎么写:六步做出一个自己的 Claude 技能
这一节帮你把"自己脑子里的套路"沉淀成 Claude 能稳定执行的手册。
最省事的起步方式是照着仓库里的 技能模板 写,整个文件不到十行:YAML 里写name和description,正文写指令和使用示例。正式流程建议走六步:
- 想清楚用途:用一两个具体例子说清"这个技能干什么、什么时候触发",描述越具体,触发越准
- 规划可复用内容:哪些步骤适合写成脚本、哪些资料适合放进 references/
- 初始化:复制模板建出技能文件夹
- 编写 SKILL.md 并实现资源:指令部分控制在一屏内,细节外移
- 打包分发:仓库提供了 skill-creator 技能,内含打包、评测、描述优化一整套工具链,可以直接让它带你走流程
- 基于真实使用迭代:拿几个测试指令跑一遍,看结果改指令,直到稳定
写指令时有两个值得学的设计。其一是渐进式披露:元数据常驻上下文(约 100 词),SKILL.md 正文控制在 5000 词以内,大块资料拆到 references/ 里按需加载——所以别把整本手册塞进主文件。其二是按维度拆分:如果你的技能覆盖多个业务域,像示例那样在reference/下分finance.md、sales.md;支持多框架或多云的就分aws.md、gcp.md,SKILL.md 里只留总导航和选择逻辑。完整规则见 Agent Skills 规范。
5 分钟验证技能是否生效:跑一条指令就够
这一节帮你确认"技能真的被触发了",而不是 Claude 假装用了。
先把技能放进工作区,用仓库自带的校验脚本做结构体检:
python skills/skill-creator/scripts/quick_validate.py my-skill/它检查元数据是否齐全、格式是否合规——能过说明技能"长得对"。接下来才是关键:直接下一句真实指令。比如对刚装的 PDF 技能说"用 PDF 技能提取这个文件的表单字段",然后看两件事——它有没有调技能里约定的脚本和步骤,输出是不是你要的格式。skill-creator 还内置了评测循环(批量跑测试指令、出对比报告、自动优化 description),技能做复杂之后可以拿它当回归测试用。
技能选型与常见坑建议:动手前先看这五条
这一节帮你避开我观察到的几个高频问题,全部是可操作的建议。
- 新手从 document-skills 起步。文档技能是生产环境同款实现,脚本齐全、容错明确,投入产出比最高;创意类技能更偏示例性质,先看再装
- description 决定生死。Claude 靠它判断"现在该不该用这个技能",务必写清"什么任务、什么信号词触发",而不是只写功能名词
- 主文件别贪大。SKILL.md 写超了,每次触发都在烧上下文;长参考、API 细节、变体方案一律外移到 references/
- 多平台先确认。技能同时支持 Claude Code、Claude.ai 和 API,但三个入口的配置方式不同,团队内先用同一个入口跑通再铺开
- 别直接押在生产上。仓库官方声明这些技能以演示和学习为目的,你在实际 Claude 里得到的实现与行为可能和仓库示例有出入,关键任务前务必在自己的环境里测过
读完之后的第一步
装一个 document-skills 就够了。装好后不用研究文档,直接对它说:
使用 PDF 技能从
path/to/some-file.pdf中提取表单字段
跑通这条指令,你就已经走完了"安装 → 触发 → 拿到结果"的全链路;接下来想沉淀自己的套路时,再回头照着模板写第一个SKILL.md。
【免费下载链接】skillsPublic repository for Agent Skills项目地址: https://gitcode.com/GitHub_Trending/skills3/skills
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考