google/skills 官方入口：Google Cloud Agent Skills 安装指南

google/skills 的官方入口地址是 github.com/google/skills，当前安装命令是 npx skills add google/skills。在准备好 npx 的终端里运行这条命令，再选择需要的 Google Cloud skill、目标 Agent 和安装范围，就能把对应能力装进本地 Agent。仓库仍在快速更新，命令和技能清单应以官方 README 为准。正文中的地址均为普通文本，不能直接点击。

先分清 google/skills 装的是什么

Agent Skill 是一组面向 Agent 的指令、参考资料和可选脚本。它不会替你开通 Google Cloud 项目，也不会自动授予云端权限；它解决的是“Agent 做某类任务时，应该读取哪些规则、按什么顺序操作”的问题。Google 的官方仓库覆盖入门、AI/ML、GKE、数据库、开发工具、Well-Architected Framework、安全和应用托管等方向，具体项目会随仓库更新而增加。

这对实际使用的影响很直接：安装 gemini-api skill 后，Agent 会得到对应的 SDK、鉴权和调用约束，但你仍需准备有效的 Google Cloud 凭据，并启用该 skill 所要求的服务或 API。不要把“skill 已安装”误当成“云资源已配置”。

安装前检查终端环境

安装器通过 npx 运行。先确认 Node.js 和 npx 能被终端找到：

node --version
npx --version

两条命令都能返回版本号，就可以继续。npx 会直接运行 Skills CLI，不要求先把 CLI 全局安装一遍；这能减少本机残留旧版命令的概率。如果终端提示找不到 node 或 npx，先从 Node.js 官网安装当前受支持版本，官网地址为普通文本 nodejs.org，安装后再重新打开终端。

按当前 README 运行安装命令

如果希望 skill 跟着某个项目走，先进入项目目录，再运行 Google 仓库给出的命令：

cd /你的项目目录
npx skills add google/skills

安装器会读取仓库中的 skill，并让你选择要安装的项目和目标 Agent。项目级安装适合随代码库共享；全局安装适合在同一台电脑的多个项目中复用。第一次安装建议保留交互选择，不要一口气装下所有 skill：选择越贴近当前任务，Agent 需要筛选的规则越少。

这张官方截图展示了“读取仓库—列出 skill—等待选择”的交互过程，但截图顶部是发布时使用的旧写法 npx skills install github.com/google/skills。当前 google/skills 仓库 README 的 Installation 段落已经写成 npx skills add google/skills，实际操作应采用新命令。旧截图适合认识界面，不适合继续复制命令。

先列清单，再做精确安装

仓库处于活跃开发阶段，发布博客里的初始数量早已不能代表当前清单。安装前用 CLI 读取仓库现状，比照着旧教程抄 skill 名更稳：

npx skills add google/skills --list

确认名称后，可以把某个 skill 精确装给指定 Agent。下面以已经在官方仓库中声明为 gemini-api 的 skill 和 Codex 为例：

npx skills add google/skills --skill gemini-api -a codex -g -y

--skill gemini-api只选择这一项，-a codex指定目标 Agent，-g使用全局范围，-y跳过确认。全局安装会影响这台电脑上的多个项目；团队仓库需要固定一套 skill 时，去掉 -g并在项目目录执行更合适。CLI 参数可在 Skills CLI 官方文档核对，文档地址以普通文本写作 skills.sh/docs/cli。

安装后做两次验证

先让 CLI 列出已经装给 Codex 的 skill：

npx skills list -a codex

列表里出现目标名称，说明文件已经落到对应 Agent 的技能目录。随后新开一个 Agent 任务，用明确请求验证触发，例如“使用 gemini-api skill 检查这段 Google Gen AI SDK 调用”。如果 Agent 没有加载它，优先检查安装时选错了 Agent、项目级与全局范围不一致，或当前 Agent 进程尚未重新读取技能目录。

仓库更新后，可按安装范围执行更新：

npx skills update -p
npx skills update -g

-p只更新项目级 skill，-g只更新全局 skill。两条命令不是要求连续执行；用哪一条取决于最初的安装范围。这个区别会直接决定你更新的是当前仓库配置，还是整台电脑共享的配置。

四个常见问题

终端提示 npx: command not found：Node.js/npm 没装好，或新安装后的 PATH 尚未被当前终端读取。重新打开终端并复查 node --version、npx --version。

能看到仓库，却找不到旧教程里的 skill：仓库会增删和调整目录，先运行 --list，再以当前 README 的链接和实际返回名称为准。

安装成功，Agent 却没有调用：检查目标 Agent 和安装范围。项目级 skill 只在对应项目路径下生效；装给别的 Agent，也不会自动出现在 Codex 中。

调用 Google Cloud 时仍然报鉴权错误：skill 只提供操作知识，不发放凭据。打开目标 skill 的 SKILL.md，按其中的兼容性、凭据、项目和 API 要求继续配置。涉及 Gemini API on Agent Platform 时，官方 skill 明确要求有效的 Google Cloud 凭据和已启用的 Agent Platform API。

交付前检查

• 入口来自 Google 官方 GitHub 仓库 github.com/google/skills，没有经过下载站或镜像包。
• 安装命令采用当前 README 的 npx skills add google/skills。
• 只选择眼下需要的 skill，并确认目标 Agent 与安装范围。
• 用 npx skills list -a codex核对结果，再用一条明确任务测试触发。
• 把 skill 安装与 Google Cloud 凭据、API 开通分开检查。

真正值得记住的只有一条：博客截图用来理解交互，仓库 README 用来执行命令。入口固定在 google/skills，但技能数量、名称和安装器参数仍会变化；每次安装前看一眼官方 README，能省掉大多数版本差异造成的返工。