1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | agent-platform-skill-registry-google-skills（SKILL.md 自述名称：“Skill Registry”） | GitHub 仓库 + SKILL.md |
| 作者/维护者 | Google（官方 google/skills 仓库，Cloud IX 团队具名提交；另有外部社区开发者通过 issue/PR 参与文档改进讨论） |
GitHub API |
| 来源链接 | https://github.com/google/skills/tree/main/skills/cloud/agent-platform-skill-registry | — |
| 许可证 | Apache License 2.0 | GitHub API 实测 |
| GitHub Stars / Forks | 所属仓库 15,237 / 1,192（整仓库口径——google/skills 是 Google 官方发布的多技能合集，非本技能独立仓库，星数不代表单个技能自身热度） |
GitHub API 实测（2026-07-25） |
| 最新版本 | 子目录 2026-05-19 新增、2026-06-24 更新（front matter 结构调整）；另有外部贡献者 2026-07-23 提交文档改进 PR（讨论中，尚未合并） | GitHub commits/PR API 实测 |
| 安装方式 | npx skills add google/skills --skill agent-platform-skill-registry，或手动复制子目录到对应 agent 的 skills 目录 |
官方 README 实测 |
2. 功能介绍与亮点
该技能让 Agent 能够直接与 Google Cloud「Gemini Enterprise Agent Platform」的 Skill Registry（技能注册表）对话式交互，把“技能”本身也当作一种可被 Agent 在运行时查询、上传、追踪的托管资源：
- 技能发现：按语义查询搜索、列出注册表中的全部技能，获取单个技能详情及其修订版本历史
- 技能生命周期管理：上传新技能、更新已有技能、永久删除技能
- 操作监控：内置工具检查长时间运行操作（LRO）的完成状态，避免上传/更新后不知道是否已生效
- 技能脚手架生成：自动生成新技能的初始本地目录结构，降低从零编写 SKILL.md 的门槛
- 配套
scripts/skill_registry_ops.py单文件实现全部操作，通过google-auth调用官方aiplatform.googleapis.comREST 接口，代码简短、逻辑透明，references/下按功能拆分为四份独立说明文档
一名外部开发者在仓库 issue 中指出了一个容易被忽视的边界：技能上传成功、修订版本存在、注册表默认版本已切换，这三者都不等于“某次具体的 Agent 运行确实加载了这个新版本”——另一位社区贡献者随即提交 PR，补充了一套端到端的版本生效验证方法，体现出该技能已被真实使用者深入实践并反馈。
3. 适用场景
所属分类：元技能与 Agent 增强
适合在 Google Cloud 上构建多技能 Agent 系统的团队：需要让 Agent 具备“发现现有技能”能力而不是靠人工告知、需要集中管理团队内多个技能的版本迭代与上下线、或需要追踪某个技能修订版本是否已在生产环境的 Agent 运行中生效。
4. 跨 Agent 兼容性
google/skills 仓库通过 npx skills 通用安装器（vercel-labs/skills）分发；该安装器 README 的 Supported Agents 表格逐一列出各 agent 的安装路径：
| Agent | 项目路径 | 全局路径 |
|---|---|---|
| Claude Code | .claude/skills/ |
~/.claude/skills/ |
| Codex | .agents/skills/ |
~/.codex/skills/ |
| OpenClaw | skills/ |
~/.openclaw/skills/ |
| Hermes Agent | .hermes/skills/ |
~/.hermes/skills/ |
四个生态均为原生支持——技能本身是标准 SKILL.md + Python 脚本 + references 文档结构，不依赖 Claude Code 专属机制，配合上表安装路径即可在任一生态中使用。
5. 推荐理由
Google 官方出品的 Skill Registry，把“Agent 该用哪个技能”从人工挑选变成 Agent 自己按语义查询、按修订版本追踪的运行时能力。对于同时维护多个技能、需要团队协作迭代技能内容的开发者，它提供了一套标准化的集中管理方案，减少“技能散落各处、版本互相覆盖”的混乱。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 官方 Google Cloud 团队维护，隶属仓库整体 15,237 stars 的官方技能仓库；该数字属整个合集，不代表本技能自身热度——本子目录已有外部开发者提交真实 issue 与文档改进 PR，账号历史悠久、活动记录正常，非刷分痕迹 |
| 可用性 | 8 | 需完成 pip install google-auth requests 与 gcloud auth application-default login，并配置 GCP_PROJECT_ID、GCP_LOCATION 环境变量；SKILL.md 提供快速上手示例与四份分功能参考文档，结构清晰；无强制付费依赖，仅需用户自有 Google Cloud 账号 |
| 安全性 | 9 | 见下方检查清单 |
| 综合 | 8.0 | 三项均值 |
安全检查清单：
① Shell 命令及权限范围：本地运行环境校验脚本与一个调用 GCP 官方 API 的操作脚本，无系统级危险操作，也不涉及用户文件系统之外的内容。
② 联网外发：仅与用户自己 Google Cloud 项目下的 aiplatform.googleapis.com Skill Registry 接口通信，用于技能的查询/上传/删除，目标单一透明。
③ 凭据处理：标准 gcloud auth application-default login OAuth 流程，凭据由 gcloud 本地凭据库统一管理，脚本本身不硬编码或另行落盘密钥。
④ 可疑指令：通读 SKILL.md 与脚本源码，未发现隐藏指令、混淆代码或异常外发；“强制环境校验”仅为常规前置检查。
⑤ 作者信誉：Google 官方仓库，具名团队提交；外部贡献者账号经核实为长期活跃真实开发者。
⑥ License：Apache License 2.0，明确清晰。
⑦ 最近维护：子目录最近一次代码提交 2026-06-24，仓库整体在最近一天内仍有推送，社区 PR 讨论持续到 2026-07-23。
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
| Anthropic 官方 Skill Creator | 面向开发者本地编写、优化、评测单个技能文件的创作工具，产出静态 SKILL.md | 聚焦技能“创作阶段”——怎么把一个技能写好；本技能聚焦技能“运行阶段”——技能写好之后如何被 Agent 在对话中按语义发现、集中存储、按修订版本追踪调用，两者分处技能生命周期的不同环节，可组合使用 |
| Model Context Protocol（MCP）的工具/资源发现机制 | 开放协议标准，Agent 通过 JSON-RPC 在会话建立时枚举已连接 MCP Server 暴露的 tools/resources 列表 | 发现范围局限于当前会话已连接的 Server，无中心化持久存储与版本历史；本技能是云端集中式、可跨会话持久化、带修订版本追踪并支持语义搜索的技能仓库，属不同抽象层的能力发现方案 |
8. 用户评价
该技能目前在第三方平台尚无正式的具名用户评分或评论。但在 GitHub 仓库的 issue/PR 讨论区，有真实开发者围绕该技能的实际使用细节展开过技术交流：一名用户提出了“注册表默认版本”与“Agent 运行时实际加载版本”之间的一致性问题，另一名用户随后提交了针对性的文档改进方案，讨论内容具体、专业，显示出该技能已被使用者真实实践过。
9. 其他补充
该技能是 google/skills 仓库“Agent Platform”系列的一员，同系列还包含 Prompt 管理、模型注册表管理、RAG 引擎管理、模型部署与端点管理等技能，均围绕 Google Cloud 上的 Agent 全生命周期管理展开，可按需组合安装。
10. 安装使用方式
- 通过安装器：
npx skills add google/skills --skill agent-platform-skill-registry，安装器会将技能放入当前 Agent 对应的 skills 目录（见第 4 章路径表） - 手动安装：克隆或下载
google/skills仓库后，将skills/cloud/agent-platform-skill-registry/整个目录复制到目标 agent 的 skills 目录下 - 安装后：需先执行
pip install google-auth requests，完成gcloud auth application-default login认证，并设置GCP_PROJECT_ID、GCP_LOCATION两个环境变量，之后无需重启 Agent 即可在对话中触发本技能（如“帮我找一个能处理 PDF 的技能”）
11. 注意事项
- 需要一个已启用 Agent Platform（原 Vertex AI）相关 API 的 Google Cloud 项目；个人开发者可用免费试用额度起步，但技能上传/查询等操作可能产生实际调用与存储费用
- 依赖
google-auth、requests两个 Python 库及本地gcloudCLI，需提前完成认证配置 - 技能强绑定 Google Agent Platform 的 REST API 数据模型，若团队使用其他云厂商或完全自建的 Agent 框架，需要额外适配后才能复用其注册表能力
- 据社区反馈，“注册表默认版本已切换”与“某次具体 Agent 运行确实加载了该版本”之间目前仍需自行验证，两者不完全等价，长时间运行或离线的 Agent 实例可能仍缓存旧版本