一、前言

使用了一段时间的反重力 Antigravity 进行日常研发，感觉非常好用，特别是 Gemini 3.1 Pro 和 Claude Opus 4.6 这两个模型，太聪明了，指哪打哪，很少返工，墙裂推荐啊。

最近 skills 很火，于是，我想给 Antigravity 点亮一些好用的技能，然后就踩坑了，它居然不认全局 skills ！

二、安装 skill

先过一遍安装流程，这里使用 npx skills 添加技能，以 git-commit 为例：

npx skills add https://github.com/github/awesome-copilot --skill git-commit

等它将仓库克隆完成后，就可以选择要安装给哪些 agents 了。

必须吐槽一下，这些 agents 的全局 skills 目录并不是统一的，例如：

• Universal：~/.agents/skills
• Antigravity：~/.gemini/antigravity/skills

我电脑上安装了 OpenCode 和 Antigravity，所以，需要将 Additional agents 里的 Antigravity 也勾选上（按空格），回车。

选择 Global，让这个 skill 安装到全局 skills 目录下（~/.agents/skills），回车。

选择 Symlink (Recommended)，让 Antigravity 链接这个 skill。

注：上面提到，很多 agents 的全局 skills 目录不统一，这里的 Copy to all agents 选项，会将当前安装的 skill，拷贝到勾选的各个 agents 自己的 skills 目录下，这样会造成磁盘空间浪费，而通过链接的方式，可以节省磁盘空间。

后面就是一路回车，等待安装完成即可。

三、问题

安装 skill 的过程非常通畅，然而，回到 Antigravity，发现它不认全局 skills！

1、路径没问题

官网文档(https://antigravity.google/docs/skills (opens new window)) 里 skills 的安装目录如下：

Scope	Location
Workspace-specific	<workspace-root>/.agent/skills/<skill-folder>/
Global (all workspaces)	~/.gemini/antigravity/skills/<skill-folder>/

这里的 Global 目录路径，与上面使用 npx skills 安装时，Additional agents 里 Antigravity 显示的路径（~/.gemini/antigravity/skills）是一致的，所以，不是路径问题。

2、链接的问题

后面折腾了一番，发现通过 Copy 的方式，Antigravity 就认这个 skill 了，真是太坑爹！

而且，亲测 MacOS 上的 Antigravity 也是一样的情况，也就是说，只要是 Symlink 链接的 skill，它就不认。

于是，问 AI：

通过 Symlink 方式添加的 skill 你不认，完整拷贝方式的 skill 你认，这是为什么？

AI 回：

我已经查明了原因：Antigravity 平台的技能加载机制目前不支持 Windows 的符号链接（Symlink）或目录联接（Junction）。

核心发现 通过对比分析，我发现平台的文件扫描器在处理 skills 目录时，会将“真实文件夹”和“链接/联接”区别对待：

• 真实文件夹：如你的 getx-helper，系统识别其属性为 isDir: true，从而能正确加载其内部的 SKILL.md。
• 链接/联接（Junction/Symlink）：如你的 find-skills、git-commit 等，系统仅将其识别为“重解析点（Reparse Point）”或普通文件，并没有将其识别为目录。因此，加载引擎在扫描时会直接跳过它们。

四、解决方案

Antigravity 不认 Symlink 链接的 skill，难道要妥协，改用 Copy 的方式吗？

突然灵光一闪，我有办法了！

既然 Antigravity 不认一个个单独链接的 skill，那链接全局 skills 目录呢？

原理： 标准的全局 skills 目录（~/.agents/skills）下的所有 skill 都是原件（非链接）！ Antigravity 只是具体到单个 skill 判断 isDir 是否为 true，链接标准的全局 skills 目录后，即可满足识别条件。

实践证明，我的猜测是正确的，通过链接全局 skills 目录，Antigravity 终于可以识别 skill 了！

1、操作步骤

按如下步骤执行：

1. 删除 Antigravity 的全局 skills 目录（~/.gemini/antigravity/skills）
2. 链接 ~/.agents/skills 到 ~/.gemini/antigravity/skills

注意：这里只是针对 Antigravity 链接全局 skills 目录，如果你有使用其他 agents，需要自行调整链接的目标路径。

MacOS 链接指令：ln -s 源路径 目标路径

ln -s ~/.agents/skills ~/.gemini/antigravity/skills

Windows 链接指令：mklink /J "目标路径" "源路径"

# cmd
mklink /J "%USERPROFILE%\.gemini\antigravity\skills" "%USERPROFILE%\.agents\skills"

# Powershell
# 方案 A: 使用 New-Item 的 Junction 类型
New-Item -ItemType Junction -Path "$env:USERPROFILE\.gemini\antigravity\skills" -Value "$env:USERPROFILE\.agents\skills"
# 方案 B: 在 PowerShell 中调用 cmd 执行 mklink
cmd /c mklink /J "$env:USERPROFILE\.gemini\antigravity\skills" "$env:USERPROFILE\.agents\skills"

2、注意事项

前面，我还在吐槽这些 agents 有各自的全局 skills 目录。

这下，链接全局 skills 目录 这招也算是 "曲线救国" 了。

以后，我们只需安装到 Universal（~/.agents/skills）即可，无须理会 Additional agents。

那么，这里再执行一次 npx skills，把 Additional agents 都去除吧，避免后面忘了。

npx skills add https://github.com/github/awesome-copilot --skill git-commit

注：上面首次安装 skill 时勾选的 Antigravity 在这里去掉了，其他同理。

好了，以上就是我对反重力 Antigravity 全局 skills 的踩坑与填坑全过程，如果对你有帮助的话，请点个赞吧🫰。

最后，我们开发的 Flutter 检测工具 FlutterEye (opens new window)，近期使用 Antigravity 做了一些 性能优化 🚀，已更新至谷歌市场，感兴趣的朋友可以了解一下，感谢大家的支持。