.agents/skills/*.md → /<skill-name>

本地或全局的 Markdown skill 会自动变成各自独立的 /<skill-name> 斜杠命令。

在工作区根目录的 .agents/skills/ 下,一个带有 frontmatter(name、description)以及 agent 指令的 Markdown 文件,会在下次启动 agy 时被编译,之后就能以 /<skill-name> 的形式在提示词输入框中使用。全局层面同理:~/.gemini/antigravity-cli/skills/ 下的 Markdown 文件,会自动作为跨所有工作区的全局斜杠命令导入。从 Gemini CLI 迁移时路径会发生变化:工作区本地路径从 .gemini/skills/ 变为 .agents/skills/,全局路径从 ~/.gemini/skills/ 变为 ~/.gemini/antigravity-cli/skills/。

✅ 什么时候用？

把一个经常重复的工作流,做成项目里可用的独立命令

在 .agents/skills/ 中创建带 frontmatter 的 format-tests.md,让 /format-tests 出现在提示词输入框中

让一个 skill 跨项目使用

把 skill 文件放到 ~/.gemini/antigravity-cli/skills/ 中

⛔ 什么时候不该用？

从 Gemini CLI 迁移过来的 skill 仍然放在旧路径(.gemini/skills/ 或 ~/.gemini/skills/)

Antigravity CLI 只会识别新路径(.agents/skills/ 或 ~/.gemini/antigravity-cli/skills/)下的 skill——旧路径不再被识别。

更好的选择: 手动把 skill 文件移动到新路径(agy plugin import gemini 只转换扩展,不处理零散的 skill 文件)

来源

Antigravity CLI Doku: Plugins ↗ antigravity.google
Antigravity CLI Doku: Gemini CLI Migration ↗ antigravity.google