VoltAgent/awesome-agent-skills 保姆级部署教程：1000+ 官方与社区 Agent 技能精选合集
一句话定位：GitHub 开源项目
VoltAgent/awesome-agent-skills是目前社区贡献最多的 Agent 技能精选合集——由主流开发团队与社区共同维护，收录了 1497+ 个经过人工筛选的真实工程技能，不是批量 AI 生成的垃圾内容，而是工程师团队真正在用的实战技能清单。slogan：A collection of official Agent Skills from leading development teams and the community. Hand-picked, not AI-slop generated.
仓库地址：https://github.com/VoltAgent/awesome-agent-skills · 许可证：MIT · ⭐ 36,679 · 技能数 1497+
▲ 图 1：VoltAgent/awesome-agent-skills 官方仓库头图（README 顶部横幅）
一、项目简介
awesome-agent-skills 本质上是一个「Agent 技能索引」——它不自己写代码，而是把全球各家开发团队和社区作者发布的优质 Agent 技能（Skill）集中收录、分类整理，让你不用满世界搜就能找到靠谱的技能包。
和市面上那些用 AI 批量生成的技能仓库不同，这个合集强调 手工筛选、真实工程团队在用。收录的技能来自 Anthropic 官方（docx、pptx、xlsx、pdf、frontend-design、mcp-builder 等 17 个）、Google Gemini 官方、OpenAI 官方、Microsoft、Vercel、Cloudflare、Netlify、Supabase、Stripe、Cursor、Figma、Notion、MongoDB、ClickHouse、DuckDB、Remotion、Replicate 等数百家一线团队和社区作者，覆盖文档处理、前端设计、测试自动化、云服务部署、数据库操作、安全审计、视频生成、音频处理等几乎所有开发场景。
项目由 VoltAgent 团队（一个 TypeScript 智能体框架团队）发起维护，采用 MIT 许可证开源，当前星标超过 3.6 万，是 GitHub 上贡献者最多的 Agent 技能合集仓库。
二、功能特点
| 能力 | 说明 |
|---|---|
| 📚 1497+ 精选技能 | 人工筛选的真实工程技能，不是 AI 批量生成的垃圾内容；按开发团队分类索引，一目了然 |
| 🔧 多框架兼容 | 一套技能格式，同时兼容 Claude Code、Codex、Antigravity、Gemini CLI、Cursor、GitHub Copilot、OpenCode、Windsurf 八大主流智能体框架 |
| 🏢 官方团队背书 | 收录 Anthropic、Google、OpenAI、Microsoft、Vercel、Cloudflare、Stripe、Supabase 等数百家官方团队发布的技能包 |
| 🧪 测试自动化全家桶 | TestMu AI（原 LambdaTest）贡献了 40+ 个测试框架技能：Playwright、Cypress、Jest、JUnit、Selenium、Pytest、Cucumber 等全覆盖 |
| ☁️ 云服务集成 | Cloudflare Workers、Vercel 部署、Netlify 函数、Supabase、Neon、ClickHouse、DuckDB、Firebase 等云平台官方技能 |
| 🎨 设计与内容生成 | Anthropic 官方前端设计、画布设计、主题工厂、Web Artifacts 构建；Remotion 程序化视频；fal.ai 图像生成；Audio 语音合成 |
| 🔒 安全审计指引 | 明确标注「精选不等于审计」，提供 Snyk Skill Security Scanner、Agent Trust Hub 等安全检测工具推荐 |
| 📏 质量标准公开 | 明确技能编写规范：第三人称描述、渐进式披露、无绝对路径、最小工具权限，保证技能可被智能体正确识别 |
| 🤝 社区共建 | 接受 PR 投稿，但强调「不要提交你三小时前刚写的技能」，只收录经过社区验证、真实使用的技能 |
三、环境要求
awesome-agent-skills 本身是一个索引型仓库，不需要安装任何依赖。你需要的是一个支持 Skill 机制的 AI 编程助手或智能体框架，以及一个存放技能的目录。
- 必备工具：任意一款支持 Agent Skill 的 AI 编程助手（Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot、OpenCode、Windsurf、Antigravity 任选其一）。
- 磁盘空间：单个技能包通常几十 KB 到几百 KB，建议预留至少 500MB 空间用于存放多个技能包。
- 网络：需要能访问 GitHub 以下载各个技能包的原始仓库（每个技能的链接指向其官方仓库地址）。
- Git：如果你打算克隆整个 awesome-agent-skills 仓库作为本地索引，需要安装 Git；如果你只是浏览网页挑选技能，则不需要。
四、保姆级部署步骤
4.1 克隆仓库（可选，作为本地索引）
如果你想把整个技能合集克隆到本地方便浏览和搜索，执行：
git clone 仓库地址.git
cd awesome-agent-skills这个仓库主要是 Markdown 索引，体积不大。克隆后可以直接在本地用编辑器打开 README.md 浏览所有技能列表。
4.2 找到你需要的技能
打开仓库的 README 页面，目录按开发团队分类。找到你想要的技能后，点击技能名称链接，它会跳转到该技能的官方仓库页面。
例如，你想让 AI 助手帮你写 Playwright 测试，就在 TestMu AI 分类下找到 testmu-ai/playwright-skill，点击链接进入 LambdaTest/agent-skills 仓库的 playwright-skill 目录。
4.3 下载技能包到你的 Agent 技能目录
每个技能本质上是一个包含 SKILL.md 文件的目录。你需要把它下载到你的 AI 编程助手对应的技能目录里。以下是各大框架的技能存放路径对照表（来自官方 README）：
| AI 编程助手 | 项目级技能路径 | 全局技能路径 |
|---|---|---|
| Claude Code | .claude/skills/ | ~/.claude/skills/ |
| Codex | .agents/skills/ | ~/.agents/skills/ |
| Antigravity | .agents/skills/ | ~/.gemini/config/skills/ |
| Cursor | .cursor/skills/ | ~/.cursor/skills/ |
| Gemini CLI | .gemini/skills/ | ~/.gemini/skills/ |
| GitHub Copilot | .github/skills/ | ~/.copilot/skills/ |
| OpenCode | .opencode/skills/ | ~/.config/opencode/skills/ |
| Windsurf | .windsurf/skills/ | ~/.codeium/windsurf/skills/ |
以 Claude Code 为例，假设你要安装 Anthropic 官方的 docx 技能（处理 Word 文档），执行：
# 1. 创建项目级技能目录（如果不存在）
mkdir -p .claude/skills
# 2. 下载技能包（以 docx 为例，从官方仓库拉取）
# 官方技能托管在 officialskills.sh 或对应团队仓库
# 你可以直接克隆该技能的仓库到 skills 目录
git clone 技能仓库地址.git .claude/skills/anthropic-skills注意：不同技能的托管位置不同。有些技能直接在 awesome-agent-skills 仓库的链接里指向了完整的 GitHub 仓库地址，你可以克隆那个仓库；有些技能托管在 officialskills.sh 上，按页面指引下载对应的 SKILL.md 文件，手动放入技能目录即可。
4.4 验证技能是否生效
安装完成后，重启你的 AI 编程助手（或开启新会话），然后用自然语言描述你想做的任务。如果技能被正确识别，助手会自动调用对应技能。
例如，安装了 docx 技能后，你可以对 Claude Code 说：「帮我把这份数据做成一个 Word 文档」，它就会自动加载 docx 技能并按照技能里的指引来操作。
五、配置说明
awesome-agent-skills 本身不需要任何配置。每个技能包内部有自己的 SKILL.md 文件，智能体框架会自动读取该文件的元数据（名称、描述、触发条件、工具权限）。
如果你想自定义技能的行为，可以直接编辑对应技能目录下的 SKILL.md 文件。官方质量标准建议：
- 描述用第三人称：写明技能做什么、什么时候用，用具体关键词（比如「PostgreSQL 迁移」而不是「数据库相关」）。
- 渐进式披露：顶层元数据控制在约 100 token 以内，技能正文不超过 500 行，大文档按需加载，不要全部塞进上下文。
- 不写绝对路径：不要硬编码
/Users/你的名字/这种机器专属路径，用相对路径或$HOME、$PROJECT_ROOT变量。 - 最小工具权限：只声明技能实际需要的工具，不要写
"tools": ["*"]这种全权限声明。
六、使用方法
6.1 浏览和挑选技能
打开 仓库首页，页面顶部的目录表格按开发团队分类。常见的高频分类：
- Anthropic 官方技能（17 个）：docx、pptx、xlsx、pdf、frontend-design、mcp-builder、webapp-testing、skill-creator 等，适合文档处理和前端开发。
- TestMu AI 测试技能（40+ 个）：Playwright、Cypress、Jest、JUnit、Selenium、Pytest、Cucumber、Mobile 测试等，适合 QA 和测试自动化。
- 云服务技能：Cloudflare Workers、Vercel 部署、Netlify、Supabase、Stripe、Neon、ClickHouse、DuckDB、Firebase 等。
- 设计与创意：Remotion 程序化视频、fal.ai 图像生成、Figma、Canvas Design、Theme Factory 等。
- 社区技能：覆盖 n8n 自动化、Blender 3D、CapCut 视频剪辑、MetaMask 钱包、电商运营、安全审计等各种小众场景。
6.2 安装技能的两种方式
方式一：手动下载（最通用）
# 1. 找到技能对应的 GitHub 仓库
# 2. 克隆或下载该技能目录到你的 skills 文件夹
# 3. 确保目录结构是：skills/技能名/SKILL.md
mkdir -p ~/.claude/skills/my-skill
# 把下载的 SKILL.md 及相关文件放入该目录方式二：用 npx 工具一键安装（部分社区技能支持）
# 例如 mblode/agent-skills 提供了 npx 安装命令
npx skills add mblode/agent-skills6.3 安全使用提醒
官方 README 明确警告：技能是「精选」的，不是「审计」过的。每个技能可能被原作者随时更新或替换。安装和使用前请注意：
- 先阅读技能的
SKILL.md和源代码，确认没有恶意指令。 - 警惕提示注入、工具投毒、隐藏恶意载荷等风险。
- 推荐使用 Snyk Skill Security Scanner 或 Agent Trust Hub 对技能做安全扫描后再使用。
- 生产环境使用前，建议在沙箱或测试环境中先验证。
七、常见问题 FAQ
问一：awesome-agent-skills 是一个需要安装的软件吗？
答：不是。它是一个「技能索引清单」，类似 awesome 系列列表。你浏览它的 README，找到需要的技能，然后按照链接去该技能的官方仓库下载，再放入你的 AI 编程助手对应的技能目录即可。它本身不需要 build、不需要运行时、不占服务。
问二：技能格式是统一的吗？Claude Code 的技能能直接给 Cursor 用吗？
答：核心格式是统一的——每个技能就是一个包含 SKILL.md 的目录。不同框架只是存放目录不同（比如 Claude Code 放 .claude/skills/，Cursor 放 .cursor/skills/）。大多数技能是通用的，你可以把同一个技能目录复制到不同框架的 skills 文件夹里使用。官方 README 提供了八大框架的路径对照表，照着放就行。
问三：我怎么知道一个技能靠不靠谱？会不会有恶意代码？
答：官方明确说「精选不等于审计」。建议：1）优先选大公司官方团队发布的技能（Anthropic、Google、OpenAI、Microsoft、Vercel 等），这些经过内部审核；2）安装前读一下 SKILL.md 和源码，看它声明了哪些工具权限；3）用 Snyk 或 Agent Trust Hub 做安全扫描；4）社区小作者的技能先在测试环境跑一跑。
问四：我可以自己写技能提交到这个合集吗？
答：可以，仓库有 CONTRIBUTING.md 指南，接受 PR 投稿。但官方明确说「不要提交你三小时前刚写的技能」——他们只收录经过社区验证、真实工程团队在使用的技能，宁缺毋滥。质量比数量重要。
问五：技能数为什么说 1497+，但我看分类好像没那么多？
答：因为除了官方团队分类，还有大量社区贡献的技能（Community 分类下），以及按主题分的子分类（比如 n8n 自动化、视频编辑、电商运营、安全审计等），加起来超过 1497 个。README 顶部的徽章实时显示技能总数，随社区贡献持续增长。
相关链接
- 项目仓库：VoltAgent/awesome-agent-skills
- 官方技能分发站：officialskills.sh
- Claude Code 技能文档：Anthropic 官方文档
- Codex 技能文档：OpenAI Codex 技能
- Cursor 技能文档：Cursor Skills
- Gemini CLI 技能文档：Gemini CLI Skills
- Windsurf 技能文档：Windsurf Cascade Skills
- OpenCode 技能文档：OpenCode Skills
- GitHub Copilot 技能文档：GitHub Copilot Skills
- 安全扫描工具：Snyk Agent Scan
- VoltAgent 框架：VoltAgent TypeScript 智能体框架