sickn33/agentic-awesome-skills 保姆级部署教程：2884+ 可复用 AI 智能体技能大全

一句话定位：GitHub 开源项目 sickn33/agentic-awesome-skills（简称 AAS）是一个收录了 2,884+ 个可安装 SKILL.md 玩法手册的技能合集仓库，一份目录同时兼容 Claude Code、Codex CLI、Cursor、Gemini CLI、Antigravity、Kiro、GitHub Copilot、OpenCode 等主流 AI 编码智能体；配套的 AAS Core 是一个本地 MCP 服务，让智能体自己在你项目里检索、挑选、校验并预览一套技能组合，再交给你审批后落地。

slogan：Find reusable instructions for your project, inspect their complete files, and keep an exact skill set you can review and reuse.

仓库地址：https://github.com/sickn33/agentic-awesome-skills · 许可证：MIT · ⭐ 49,000+ · 最新版 V20.3.0

▲ 图 1：AAS 仓库头部展示的 Star 49,000+ 金色徽章与官方 Buy Me a Coffee 支持横幅（来自仓库 README assets 目录，官方截图）

一、项目简介

Agentic Awesome Skills 是一个独立社区维护的技能目录项目，它把"提示词工程 / 方法论 / 工作流"沉淀成一份份可被智能体直接加载的 SKILL.md 手册。每个技能是一个独立文件夹，里面除了主手册还可以附带脚本、参考资料与示例；你不需要把 2884 个全部塞进上下文，而是按需挑选、按需安装，或者交给 AAS Core 让智能体基于你的项目自己挑。

项目当前发布版本为 V20.3.0，收录技能数 2,884+，由 GitHub 仓库作为 canonical 源，托管目录站 aaskills.tech 与浏览器端 Workbench 作为辅助检索与预览界面。它和 Google、Anthropic、OpenAI、Cursor 等公司没有官方隶属关系，README 明确声明所有品牌名仅用于描述兼容与安装目标。

从内容来源看，目录里既有 anthropics/skills、openai/skills、microsoft/skills、google-gemini/gemini-skills、vercel-labs/agent-skills、supabase/agent-skills、huggingface/skills 等官方仓库的技能，也收录了大量独立作者与社区贡献者的玩法手册，覆盖前端、后端、安全、数据分析、DevOps、可访问性、AI 产品评测、SaaS 上线等领域。

二、功能特点

三、环境要求

• Node.js 运行时：需要本机已安装 Node.js 并能跑 npx（仓库直装命令基于 npm exec / npx）。
• 宿主智能体：至少装一个支持技能加载的 AI 编码智能体——Claude Code、Codex CLI、Cursor、Gemini CLI、Antigravity、Kiro、OpenCode 等任选其一；AAS Core 本地 MCP 目前仅针对 Codex 与 Claude Code 提供完整的挑选—校验—预览链路。
• 磁盘与网络：直装技能会写到宿主技能目录（如 .agents/skills、~/.claude/skills、~/.cursor/skills 等），目录本体按需拉取；首次运行需要能访问 npm 源与 GitHub。
• 权限边界：AAS Core 只做结构与身份校验，不会替你判断语义是否合适、是否安全、是否该真正落地；Apply 与 recovery 是实验性功能，需要显式 opt-in。

四、保姆级部署步骤

4.1 准备：确认 Node 与宿主智能体

先确认本机 Node 可用：

node -v
npm -v
npx -v

任意版本输出即可。然后确认你打算用的宿主（以 Claude Code / Codex / Cursor / Gemini CLI 为例）已经安装并能正常启动。

4.2 方式 A：直装指定技能（最快上手）

如果你已经知道想要哪几个技能（例如官方 README 反复举例的 brainstorming、systematic-debugging），先用 --dry-run 预览一次将要写入的文件：

npm exec --yes --ignore-scripts --package=agentic-awesome-skills@20.3.0 -- \
  agentic-awesome-skills --release 20.3.0 --path .agents/skills \
  --skills brainstorming,systematic-debugging --dry-run

预览无误后，去掉 --dry-run 正式写入：

npm exec --yes --ignore-scripts --package=agentic-awesome-skills@20.3.0 -- \
  agentic-awesome-skills --release 20.3.0 --path .agents/skills \
  --skills brainstorming,systematic-debugging

切换到不同宿主时，把 --path 换成对应目录即可（README 给出的常用目标）：

GitHub Copilot 走 gh skill 官方扩展（README 标注为 preview）：

gh skill install sickn33/agentic-awesome-skills skills/brainstorming/SKILL.md \
  --agent github-copilot --scope user --pin v14.2.0

4.3 方式 B：给 Codex 配置 AAS Core 本地 MCP

AAS Core 的核心是让智能体自己检索全量目录、挑技能、校验结构并生成 plan。第一次配置会写一份变更预览并返回审批摘要：

npm exec --yes --ignore-scripts --package=agentic-awesome-skills@20.3.0 -- aas mcp configure \
  --host codex \
  --scope user \
  --config /absolute/path/to/codex/config.toml \
  --cache-root /absolute/path/to/aas-cache

换成 Claude Code 时，把 --host codex 改成 --host claude，并把 --config 指向 Claude 的配置文件路径，--cache-root 指向一个本地缓存目录。详细的审批、重连、校验与 plan 流程见官方 AAS Core 指南。

4.4 让智能体挑技能并预览 plan

MCP 配好之后，直接在 Codex / Claude 里让它"看看我的项目，从 AAS 目录里挑合适的技能，存一份清单"。智能体会：

1. 读取项目上下文，检索全量本地目录（每个技能都可单独搜索、可读全文）。
2. 调用只读的 compose_stack 工具在内存里校验你挑中的 ID 与结构。
3. 由客户端或 aas CLI 落盘 aas-stack.json 与可选的选择证据。

随后你手动跑两条命令审阅：

aas stack validate     # 校验 manifest
aas stack plan         # 写一份不可变的 plan 预览给你审阅

manifest 技术上限是 128 个技能；Core 不会替你排名或推荐候选，也不会在这个预览链路里直接安装。审阅通过后，用 aas stack install-preview 把这份经过审批的清单交给直装器去落地（该命令只准备 --dry-run 预览，不会真正应用 Core plan）。

4.5 浏览器端 Workbench 审阅

不想在终端里看 plan？打开 Workbench，在浏览器内存里加载并审阅 stack 与 plan 产物——它不会访问你本地文件系统。

五、配置说明

• 缓存目录：通过 --cache-root 指定，全量目录会被拉到本地供智能体检索；升级时重新拉取即可。
• 安装作用域：--scope user 写进用户级配置，所有项目共享；--project 只对当前项目生效，按需选择。
• 过滤参数：直装器支持 --category development,backend、--risk safe,none、--tags xxx 等过滤器，避免一次塞进太多技能撑爆上下文。
• 版本钉死：用 --release 20.3.0 或 --package=agentic-awesome-skills@20.3.0 把版本钉在当前发布，避免跟随 main 分支发生漂移。
• Antigravity 特别提示：Antigravity 的 watched 技能目录容易被大量技能撑爆上下文，官方默认目标要求你显式给出 --skills <ids> 或 --filter，或显式加 --all 才会全量安装。

六、使用方法

6.1 在不同宿主里调用技能

技能装好之后，按宿主的约定调用即可，README 给出的第一句用法示例：

6.2 浏览全量目录

想自己挑技能时，可以在托管目录站 aaskills.tech 浏览，或直接看仓库根目录的 CATALOG.md；机器可读清单是 skills_index.json，每个技能本体在 skills/<skill-name>/SKILL.md。

6.3 领域插件包

如果不想一个一个挑，官方把高频场景打成了聚焦插件包（Claude Code 与 Codex 可用，兼容包也提供标准 Agent Plugins manifest）：Web App Builder、Product Design Studio、Security Engineer、Secure App Builder、Documents & Presentations、Data Analytics、Agent & MCP Builder、QA & Test Automation、DevOps & Cloud、Accessibility & Inclusive UX、API Platform Builder、SaaS Launch & Revenue、AI Product & Evaluation Ops。完整清单见 在线插件目录 或仓库 plugins/ 目录。

七、常见问题 FAQ

问一：AAS Core 会不会自动替我决定"用哪个技能最好"，并直接安装？
答：不会。Core 的定位是 agent-first preview：它帮你在本地检索全量目录、由智能体挑选候选、在内存里校验结构、生成一份可审批的 plan，但不排名、不推荐、不自动安装。manifest 技术上限 128 个技能；真正的 Apply 与 recovery 是实验性功能，需要你显式 opt-in，并且官方明确声明"结构合法"不等于"语义合适、兼容、配置正确、运行安全"。

问二：我已经知道想要哪几个技能，能不能跳过 Core 直接装？
答：可以。直接用直装器，先 --dry-run 预览再去掉 --dry-run 正式写入即可（见 4.2 节）。直装器不会消费或应用 Core plan，两条路径是平行的：Core 给"挑"的过程加上审批，直装器给"装"的过程加上预览。

问三：技能装太多会不会把智能体上下文撑爆？
答：会，尤其是 Antigravity 这种 watched 技能目录。官方建议：① 用 --skills 显式指定，或用 --category / --risk / --tags 过滤；② 参考 Linux/macOS 过载与选择性激活指南；③ Windows 用户遇到上下文截断可参考 Windows 截断恢复指南。

问四：装的技能里会不会有恶意脚本？
答：仓库采用 MIT 许可证，收录了大量第三方来源的技能，官方 README 专门提供了 安全与杀毒告警指南。建议：① 优先用 --dry-run 预览每个技能将写入哪些文件；② 对带脚本的技能先审一遍脚本再启用；③ 部分第三方技能需要调用其托管 MCP / API（可能付费），在技能卡片里会写明，按自己的风险偏好选择。

问五：这个项目和 Google / Anthropic / OpenAI 是什么关系？
答：是独立社区项目，与 Google、Anthropic、OpenAI、Cursor 等公司没有官方隶属关系，README 明确声明所有品牌名仅用于描述兼容与安装目标。它收录了 anthropics/skills、openai/skills、microsoft/skills、google-gemini/gemini-skills 等官方仓库的技能，并在 Credits & Sources 一节完整署名。

相关链接

• 项目仓库：sickn33/agentic-awesome-skills
• 发布下载：Releases 页面
• 托管目录站：aaskills.tech
• 浏览器 Workbench：aaskills.tech/workbench
• 在线插件目录：aaskills.tech/plugins
• AAS Core 指南（v20.3.0）：docs/users/aas-core.md
• Codex CLI 配置：Codex setup
• Claude Code 配置：Claude Code setup
• 全量目录 CATALOG：CATALOG.md
• 安全与杀毒指南：security-and-antivirus.md
• X（推特）官方账号：@AASkills_