本教程依据已读取的Google Antigravity官方文档编写，是Skills-SI独立指南而非Google官方教程。官方文档确认Antigravity IDE原生支持Agent Skills及其目录、发现和调用方式；不把MCP等同Skill。官方已读资料未说明本地Skill专用卸载按钮、刷新操作或跨版本一致性。本轮未安装或登录，未实测步骤；Skills-SI具体下载包、作者及许可证须以对应条目实际信息核验。
準備
- 从Google Antigravity官方页面下载并安装桌面IDE；官方要求：macOS 12及以上（Apple Silicon或Intel）、Windows 10 64位及以上，或Linux glibc ≥2.28、glibcxx ≥3.4.25。
- 首次打开IDE需要使用个人Google账号或Gemini Enterprise商业账号登录；本次不执行登录。
- 准备Skills-SI下载的Skill完整目录，并在安装前核对来源、作者、许可及脚本。需要的外部程序、网络服务或API应按Skill作者说明另行确认；不得把MCP服务器当作Skill。
導入と利用手順
- 01
1. 准备Antigravity IDE
确认操作系统满足官方最低要求。从Google官方下载安装桌面IDE并完成首次启动；官方说明首次使用需登录。此指南只讲独立桌面IDE，不将CLI或MCP配置混入Skill安装。
根拠と出典SKILL.md + resources動作確認手順・フォルダーの概念図。公式画面ではありません。 - 02
2. 从Skills-SI获取并安全检查Skill
在Skills-SI市场找到目标Skill并下载其提供的包。核对本站条目所列作者、来源、许可和包内容；打开SKILL.md及附带脚本、示例、资源检查用途与风险。若作者、许可或来源无法核实，先停止安装；不要关闭安全防护，也不要直接运行未知脚本。
根拠と出典SKILL.md + resources動作確認手順・フォルダーの概念図。公式画面ではありません。 - 03
3. 解压并确认完整目录
解压到本地临时位置，找到包含SKILL.md的技能文件夹。保留该目录中的scripts、examples、resources等附属内容；不要只复制SKILL.md。检查SKILL.md开头的YAML中有必需的description，name可省略并默认取文件夹名。
根拠と出典SKILL.md + resources動作確認手順・フォルダーの概念図。公式画面ではありません。 - 04
4. 安装到工作区或全局目录
工作区范围：将完整技能目录放入当前项目根目录的 .agents/skills/<skill-folder>/。全局范围：放入 ~/.gemini/config/skills/<skill-folder>/，供此设备的项目使用。Antigravity IDE还支持旧全局目录 ~/.gemini/antigravity/skills/。选择一个范围并避免重复副本；这些是官方文档列明的路径。
<workspace-root>/.agents/skills/<skill-folder>/ 或 ~/.gemini/config/skills/<skill-folder>/（旧版全局目录：~/.gemini/antigravity/skills/）根拠と出典<workspace-root>/.agents/skills/<skill-folder>/ 或 ~/.gemini/config/skills/<skill-folder>/（旧版全局目录：~/.gemini/antigravity/skills/）動作確認手順・フォルダーの概念図。公式画面ではありません。 - 05
5. 调用Skill并完成第一次练习
在Antigravity提示框描述清晰、低风险的虚构任务；相关Skill可由智能体按上下文自动读取。也可输入 /<skill-name> 显式调用，名称使用Skill定义的名称（若未写name则默认为目录名）。先让它产出草稿，不授权不必要的脚本或文件操作。
/<skill-name>（在提示框中输入；将占位符替换为实际技能名）根拠と出典SKILL.md + resources動作確認手順・フォルダーの概念図。公式画面ではありません。 - 06
6. 验证结果与Skill是否被发现
打开Agent侧栏的Customizations菜单查看活动Skills；也可在对话中显式输入技能斜杠名，确认能选中并按其说明工作。检查输出是否符合Skill的要求，并人工复核内容。若列表、刷新时机或当前版本行为与文档不一致，不要猜测隐藏菜单或命令；核对路径与版本后参考官方支持信息。
Antigravity IDE：Agent侧栏中的 Customizations 菜单（官方文档所述）/<skill-name>（可用于显式调用检查）根拠と出典Antigravity IDE：Agent侧栏中的 Customizations 菜单（官方文档所述）動作確認手順・フォルダーの概念図。公式画面ではありません。 - 07
7. 移除Skill或卸载IDE
移除Skill时，先确认其实际安装范围，再仅删除该Skill对应的完整文件夹；不要误删其他Skill。官方已读文档未说明此类本地Skill的专用卸载按钮或刷新操作。卸载Antigravity IDE则使用操作系统提供的正常应用卸载方式；此处不猜测未核实的菜单或命令。
删除所选Skill实际所在目录中的 <skill-folder>/；全局或工作区路径见第4步根拠と出典删除所选Skill实际所在目录中的 <skill-folder>/；全局或工作区路径见第4步動作確認手順・フォルダーの概念図。公式画面ではありません。
練習と合格基準
用虚构会议材料测试目标Skill：‘整理这段虚构会议记录，输出不超过5项行动、负责人角色和期限；资料未说明的字段写“待确认”，不要创建或修改文件。’检查是否遵循Skill说明且未捏造信息。
- 在Agent侧栏的Customizations菜单查看活动Skills（官方Skills文档列明该位置）。
- 用/<skill-name>在提示框显式调用，确认能选中目标名称；自然语言提示下也可观察相关Skill是否被采用。
- 用虚构输入完成练习，对照SKILL.md核验输出格式、未说明字段与实际结果；不要仅以智能体声称已调用作为验证。
無効化と削除
- 确认技能实际位于工作区、当前全局目录或旧版全局目录中的哪一处。
- 移除Skill时只删除对应的完整技能文件夹，保留其他目录；官方文档未提供本地Skill专用卸载按钮或刷新命令。
- 如需卸载Antigravity IDE，按所用操作系统的一般应用卸载流程操作。已读取的官方页面未列出逐系统卸载步骤，因此不提供未经核实的菜单路径或命令。
トラブル対応
Skill没有出现在活动Skills中。
核对是否把包含SKILL.md的完整技能文件夹直接放进官方支持的工作区或全局路径，并确认选对项目范围；检查YAML frontmatter与description。官方文档没有说明本地Skill专用刷新步骤，不猜测命令。
斜杠调用找不到目标Skill。
使用SKILL.md中的name；若未设置name，官方规范规定默认使用文件夹名。确认名称拼写，并确认技能目录位于当前工作区或全局支持路径。
技能被发现但任务中没有按预期触发。
官方说明自动调用取决于任务相关性。明确描述任务，也可用/<skill-name>显式调用；检查description是否清楚说明适用场景，并复核Skill输出。
Skill脚本无法运行或要求未预期权限、外部服务。
先阅读脚本与Skill说明，核对所需运行环境、程序、网络或API；本平台不会自动保证这些依赖已安装。只从可信来源单独处理确有需要的依赖，不输入密钥到对话，也不要为排错关闭防护。
根拠と出典
- https://antigravity.google/docs/skills/
官方说明Skill是含SKILL.md的目录，可带scripts/examples/resources；列出Antigravity IDE的工作区、全局及旧全局路径、自动调用、/<skill-name>调用和Agent侧栏Customizations检查入口。
- https://antigravity.google/docs/getting-started/
官方列出Antigravity IDE下载、操作系统最低要求、首次登录和项目工作区基本流程。
- https://antigravity.google/download/
官方下载安装页列出Antigravity桌面应用及当前页面所示版本和系统支持信息。
- https://antigravity.google/docs/projects/
官方说明Project由一个或多个文件夹组成，具有隔离的Agent设置；可用于理解工作区范围，但Skills具体路径以Skills文档为准。