sickn33/antigravity-awesome-skills 保姆级部署教程：Antigravity 版 AI 智能体技能合集

一句话定位：GitHub 开源项目 sickn33/antigravity-awesome-skills 是 Agentic Awesome Skills（AAS）面向 Antigravity IDE / Antigravity CLI（agy） 的适配发行版——把 2,884+ 个可复用的 SKILL.md 智能体技能剧本，一键装到 Claude Code、Codex、Cursor、Gemini CLI、Antigravity 等编码智能体的技能目录里，让 AI 自动按既定流程干活。

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/antigravity-awesome-skills · 许可证：MIT · ⭐ 48,916 · 当前版本 V20.3.0 · 收录技能 2,884+

▲ 图 0：antigravity-awesome-skills 官方仓库展示的项目横幅与 Stars / Antigravity 适配徽章（2026-10-31 官方截图）

一、项目简介

antigravity-awesome-skills 是热门开源技能库 Agentic Awesome Skills（AAS）的 Antigravity 变体版本。它与作者主仓库 sickn33/agentic-awesome-skills 通过 registry-sync 保持同步（本 README 头部 registry-sync: version=20.3.0; skills=2884; stars=48871 即为同步标记），内容、技能目录、安装器完全一致，区别在于本仓库把 Antigravity IDE / Antigravity CLI（agy）作为一等公民的安装目标来对待，并在文档里专门写了 Antigravity 的上下文过载保护与选择性激活方案。

所谓「技能（Skill）」，就是一份份带任务指令、示例与边界说明的 Markdown 剧本（SKILL.md）。AI 编码智能体本身很聪明，但不知道你的工具链细节；把对应技能丢进它的技能目录后，它在做对应任务时会自动读取并遵循这套流程——比如 brainstorming 帮你做特性头脑风暴、systematic-debugging 按系统化排错流程定位 bug、backend-dev-guidelines 约束后端代码风格。

项目以 MIT 许可证开源，是独立社区项目，与 Google 无隶属或背书关系（Google、Antigravity、Gemini 等名称仅描述兼容与安装目标）。托管目录站点见 aaskills.tech，可在浏览器里直接浏览 2,884+ 技能清单。

二、功能特点

三、环境要求

• Node.js / npm：需要能跑 npx 的 Node 环境（推荐 LTS），安装器通过 npm exec --yes --ignore-scripts 临时拉取 agentic-awesome-skills@20.3.0。
• Git 2.25+：20.3.0 安装器会把 release commit 与 npm 元数据比对后，浅克隆稀疏拉取 canonical 技能树；Git 版本过低会失败。
• 网络：出口需能访问 npm registry 与 GitHub（raw.githubusercontent.com / github.com）以下载技能树；托管目录站 aaskills.tech 用于浏览。
• 宿主智能体：至少装一个支持技能目录的编码智能体——Claude Code、Codex CLI、Cursor、Gemini CLI、Antigravity IDE、Antigravity CLI（agy）等；Antigravity 安装目标默认落到 ~/.agents/skills。
• 磁盘：完整技能树较大，建议先按 ID 精确安装，不要一上来 --all；完整克隆另留数百 MB 余量。

四、保姆级部署步骤

4.1 前置：确认 Node 与 Git

打开终端，先确认两个版本都达标：

node -v
npm -v
git --version

Git 需要 2.25 以上；Node 建议 LTS。若 npx 不可用，先装 Node.js。

4.2 先干跑（dry-run）：只看预览不落盘

antigravity-awesome-skills 对 Antigravity 做了上下文保护——不允许你无脑全量安装。先选两个最常用的技能试一下：brainstorming（头脑风暴）和 systematic-debugging（系统化排错）：

npx --yes --ignore-scripts --package=agentic-awesome-skills@20.3.0 -- \
  agentic-awesome-skills --release 20.3.0 --antigravity \
  --skills brainstorming,systematic-debugging --dry-run

终端会打印将要复制到 ~/.agents/skills 的文件清单与风险摘要。确认无误后，去掉 --dry-run 真正落盘：

npx --yes --ignore-scripts --package=agentic-awesome-skills@20.3.0 -- \
  agentic-awesome-skills --release 20.3.0 --antigravity \
  --skills brainstorming,systematic-debugging

注意：这里用的 npm 包名仍然是 agentic-awesome-skills（Antigravity 变体与主仓库共用同一份发布包），--antigravity 开关决定安装目标目录；别去搜一个不存在的 antigravity-awesome-skills npm 包。

4.3 安装前审计（推荐）

落盘前可以先静态审计一遍你打算装的技能里有没有高风险能力：

npx --yes agentic-awesome-skills audit --skills brainstorming,backend-dev-guidelines

审计报告会标注涉及网络、shell、文件写入等能力的技能，但它只是静态检查，不等于「安全认证」——真正要不要用，仍需你读一遍对应 SKILL.md。

4.4 Antigravity CLI（agy）路径

如果你用的是 Antigravity CLI 而不是 IDE，直接用 --agy 开关：

npx --yes agentic-awesome-skills --agy

装完后在 agy 里用斜杠调用技能，例如：

/brainstorming help me plan a feature

4.5 AAS Core 高级路径（让智能体自己选技能）

如果你用 Codex 或 Claude Code，可以挂 AAS Core 本地 MCP，让智能体自己读项目、搜完整目录、挑出精确技能 ID。首次配置命令会先预览变更并返回一个审批摘要：

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 就把 --host codex 换成 --host claude，并填 Claude 的配置文件路径。配置好后让智能体检查项目并选定技能，再用 aas stack install-preview 生成交给直接安装器的 dry-run 预览。完整流程见官方 AAS Core 指南。

4.6 其他宿主一条命令速查

五、配置说明

• 安装目标目录：Antigravity 安装到 ~/.agents/skills；可用 --path <dir> 覆盖。manifest 技术上限 128 个技能，超了会被截断。
• 选择性安装：除了 --skills <id1,id2>，还支持 --category development,backend、--risk safe,none、--tags 等元数据过滤，避免一次塞太多。
• 版本锁定：生产环境建议始终带 --release 20.3.0 与 --package=agentic-awesome-skills@20.3.0 锁版本，不要用移动的 GitHub main 分支当捷径。
• 上下文过载恢复：如果 Antigravity 已经因为装太多技能而进入截断/崩溃循环，按官方 selective activation 指南 精简技能目录。
• Windows 截断恢复：Windows 下长路径/上下文截断问题见 Windows truncation recovery 文档。

六、使用方法

安装完成后，技能会出现在对应智能体的技能目录里。在 Antigravity IDE 或 agy 里，直接用自然语言或斜杠触发即可：

@brainstorming help me plan a feature
/systematic-debugging why is the login request timing out

在 Cursor 里用 @brainstorming help me plan a feature；在 Gemini CLI / Codex 里用 Use brainstorming to plan a feature。智能体读到对应 SKILL.md 后会按剧本里的步骤、示例与边界约束来干活。

想浏览完整技能清单，直接打开托管目录站 aaskills.tech，或在仓库根目录看 CATALOG.md；机器可读的索引是 skills_index.json。

七、常见问题 FAQ

问一：antigravity-awesome-skills 和 agentic-awesome-skills 是什么关系？
答：同一作者 sickn33 的姊妹仓库。antigravity-awesome-skills 通过 registry-sync 与主仓库 agentic-awesome-skills 保持内容同步（README 头部的 registry-sync: version=20.3.0; skills=2884 就是同步标记），技能目录、安装器、npm 包完全一致；本仓库的定位是把 Antigravity IDE / agy 作为重点适配目标，并在文档里专门写了 Antigravity 的上下文保护与选择性激活方案。

问二：为什么我直接跑 npx agentic-awesome-skills --antigravity 会报错？
答：这是有意设计。Antigravity 监听的技能目录一旦装多会撑爆上下文、进入截断崩溃循环，所以 20.3.0 起裸命令与 --antigravity 强制要求 --skills <ids> 精确清单、--category/--risk/--tags 过滤，或显式 --all 覆盖。请先选 2–5 个技能试装，不要一上来全量。

问三：npm 包名到底是哪个？要装 antigravity-awesome-skills 这个包吗？
答：npm 上发布包名是 agentic-awesome-skills，Antigravity 变体与主仓库共用同一份发布包；通过 --antigravity 或 --agy 开关决定安装目标目录。不要去搜一个叫 antigravity-awesome-skills 的 npm 包，那不是官方发布。

问四：装了技能会不会有安全风险？
答：技能本质是 Markdown 指令，安装文本不会被自动执行，但加载后会影响智能体行为。官方建议：先用 npx agentic-awesome-skills audit --skills <ids> 静态审计，再人工读一遍对应 SKILL.md；涉及网络、shell、写文件的技能尤其要审。详见 Security and antivirus 文档。

问五：Antigravity 已经因为装太多技能卡死了怎么办？
答：按官方 selective activation 指南精简技能目录——只保留当前项目真正用得到的 5–15 个技能，其余从 ~/.agents/skills 移走。manifest 技术上限是 128 个技能，超过会被截断；日常使用建议远低于这个数。

相关链接

• 项目仓库（Antigravity 变体）：sickn33/antigravity-awesome-skills
• 主仓库（AAS 本体）：sickn33/agentic-awesome-skills
• 发布下载：Releases 页面
• 托管技能目录：aaskills.tech
• AAS Core 指南：aas-core.md
• Codex 接入文档：Codex setup
• Claude Code 接入文档：Claude Code setup
• 上下文过载恢复：agent-overload-recovery.md
• 安全与杀毒提示：security-and-antivirus.md
• X 官方账号：@AASkills_