google/skills · 上手攻略

仓库：google/skills
链接：https://github.com/google/skills
分类：Agent工具 · Google Cloud技能集
作者：Tom
更新：2026-08-05

是什么

google/skills 是 Google 官方维护的 Agent Skills 开源集合（npx skills add google/skills），覆盖 Google Cloud 全产品线（包括 GKE、BigQuery、Gemini API、Cloud SQL、Spanner、Cloud Logging 等），以及 Google Workspace（Drive、Gmail、Calendar、Sheets）等产品。每一个 Skill 都是一段结构化的 SKILL.md，定义触发条件、描述和使用指引，供 AI Agent 在特定场景下调用。

当前由 Google 官方驱动，持续更新，是目前最权威的 Google Cloud Agent Skills 集合。

解决什么问题

Agent 不知道如何操作 GCP：AI 无法凭空知道 gcloud 命令行参数、kubectl 用法或 BigQuery SQL 方言。
文档查找成本高：开发者需要反复翻 Google Cloud 官方文档，Agent 也没有系统性覆盖。
跨产品操作上下文缺失：GKE + BigQuery + Gemini API 的联动操作，没有统一 Skill 将它们串联。
企业场景覆盖不足：从 Onboarding 到 RAG 引擎管理，从 GKE 扩缩容到 Cloud Monitoring，都有对应 Skill。

快速安装

# 一次性安装全部 skills（交互式选择要安装的子 skill）
npx skills add google/skills

# 全局安装（安装到全局 skills 目录）
npx skills add google/skills -g

# 安装后查看可用 skills 列表
npx skills list

前提：需安装 Node.js + npm，以及 npx 可用。Agent Skills 工具由 agentskills.io 提供底层支持，安装命令依赖 npx skills CLI。

核心用法

Skill 分类概览

google/skills 的 Skill 分为以下大类（主要在 skills/cloud/ 目录下）：

AI / ML 类（Gemini & Vertex AI）

Skill 名称	功能
`gemini-api`	Gemini API 在 Agent Platform 中的使用
`gemini-agents-api`	Gemini Enterprise Agent Platform Managed Agents API
`gemini-interactions-api`	Gemini 交互 API
`google-cloud-solution-agentic-ai-bidirectional-streaming`	实时双向多模态流式 AI 方案
`agent-platform-inference`	Agent Platform GenAI 推理
`agent-platform-deploy`	Vertex AI Model Garden 部署
`agent-platform-model-registry`	模型注册表管理
`agent-platform-tuning`	模型微调
`agent-platform-prompt-management`	Prompt 管理
`agent-platform-rag-engine-management`	RAG 引擎管理
`bigquery-ai-ml`	BigQuery 内置 AI/ML 功能

GKE（Kubernetes）类

Skill 名称	功能
`gke-inference`	GKE AI/ML 推理
`gke-basics`	GKE 基础与关键坑点
`gke-cluster-creation`	集群创建
`gke-cluster-autoscaler`	自动扩缩容
`gke-workload-scaling`	Workload 扩缩
`gke-networking`	网络配置
`gke-storage`	存储
`gke-backup-dr`	备份与灾难恢复
`gke-productionize`	生产化
`gke-golden-path`	Golden Path 配置
`gke-manifest-generation`	K8s Manifest 生成
`gke-multitenancy`	多租户

数据库类

Skill 名称	功能
`bigquery-basics`	BigQuery 基础
`bigquery-bigframes`	BigFrames（BigQuery DataFrame）
`alloydb-basics`	AlloyDB 基础
`cloud-sql-basics`	Cloud SQL 基础
`bigtable-basics`	Bigtable 基础
`spanner-basics`	Spanner 基础

开发者工具类

Skill 名称	功能
`gcloud`	gcloud CLI Skill for AI Agents
`google-agents-cli-onboarding`	Google Agents CLI 入门
`developer-device-platform-basics`	开发者设备平台

管理与可观测性

Skill 名称	功能
`cloud-monitoring-chart-generation`	Monitoring 图表生成
`cloud-logging-configuration-basics`	Cloud Logging 配置
`google-cloud-networking-observability`	网络可观测性

最小可跑命令

# 1. 确认 Node.js 和 npx 可用
node --version   # >= 18
npx --version    # >= 9

# 2. 安装 google/skills（交互式，会列出所有子 skill 供选择）
npx skills add google/skills

# 3. 查看已安装 skills
npx skills list

# 4. 触发特定 skill（在 Agent 对话框中）
# 例如需要 GKE 入门引导：
# "使用 google-cloud-recipe-onboarding skill 引导我在 GCP 上部署第一个应用"

# 5. 在 Agent 中触发 gcloud skill
# "使用 gcloud skill 为我创建一个 GKE 集群，名称为 demo-cluster，区域 us-central1"

Google Cloud Onboarding Skill 详解

以 google-cloud-recipe-onboarding 为例，Skill 定义的触发条件：

适用场景：新开发者首次初始化 GCP 项目、配置账单、部署第一个资源
不适用：企业级多项目架构（用 google-cloud-setup guided flow）

执行原则（SKILL.md 中定义）：

Mutate 前必审计：对项目或账单做任何变更前，先静默执行 pre-execution 状态审计
单问题策略：每次只问用户一个操作参数或确认，不要一次性列出所有选项
非交互输出：所有 mutation 命令追加 --quiet / --format="json" 防止终端挂起
首次触发引导：主动提示用户创建 Google Cloud 账号并执行 gcloud auth login

# Onboarding 典型流程示例
gcloud auth login
gcloud projects create my-demo-project --location=us-central1
gcloud billing projects link my-demo-project --billing-account=XXXXX
gcloud services enable container.googleapis.com --project=my-demo-project
gcloud container clusters create demo-cluster --region=us-central1 --project=my-demo-project

典型适用场景

AI Coding Agent + GCP：在 Cursor / Claude Code 中操作 GKE、BigQuery、Gemini API，无需查阅文档
自动化云运维：GKE 扩缩容、集群创建、日志配置等，用 Agent 驱动而非脚本
GCP 入门引导：新工程师 onboarding，一个 Skill 带完所有初始化步骤
RAG 系统部署：用 agent-platform-rag-engine-management 快速在 Vertex AI 上建 RAG
数据工程：BigQuery + BigFrames + AlloyDB 的操作 Skill 全套覆盖

坑与注意

坑	说明
需要提前配置 gcloud 认证	Agent 执行 GCP 操作前必须 `gcloud auth login`，Skill 不会自动处理
Skill 覆盖范围不完整	某些新兴服务（如某些 Vertex AI 功能）可能尚未收录，需对照官方文档
生产环境慎用	Skill 定义的是"happy path"，生产高可用配置需额外人工审核
账单操作需双重确认	`billing projects link` 等操作不可逆，Skill 虽有审计机制仍需用户明确授权
多 region 配置未覆盖	涉及多区域部署的复杂场景，部分 Skill 描述有限
agentskills.io CLI 版本	不同版本 `npx skills` 行为可能有差异，建议确认 CLI 版本

与同类对比

仓库	特点	google/skills 优势
vercel-labs/skills	Vercel AI SDK 生态 Agent Skills	google/skills 覆盖 Google Cloud 全产品线，Google 官方维护
addyosmani/agent-skills	通用 Web 开发 Skills 集合	google/skills 专注于 Google Cloud，深度更优
phuryn/pm-skills	PM Tools Skills 集合	领域不同，无直接竞争
nvidia/skill-spector	Agent Skill 安全扫描	互补关系，可对 google/skills 进行安全扫描

核心差异：google/skills 是目前唯一 Google 官方维护、覆盖 GCP 全产品线的 Agent Skills 集合，且 SKILL.md 格式规范（触发条件、使用边界、审计策略俱全），适合严肃的企业场景。

一句话推荐结论

如果你在 AI Coding 环境中使用 Google Cloud 产品（不论是 GKE、BigQuery 还是 Gemini API），google/skills 是目前最权威、覆盖最全的官方 Skill 集合，可以让 Agent 直接驱动 GCP 操作，省去大量文档查阅时间。

来源：https://github.com/google/skills · https://skills.sh/google/skills · https://agentskills.io/home · SKILL.md（google-cloud-recipe-onboarding / gke-basics / gcloud）
不确定处：Skill 集合的更新频率和版本管理机制未明确说明；agentskills.io CLI 的具体版本要求未在 README 中标注；部分子 skill（如某些 solution-architecture 类）的详细触发条件和参数定义需实际安装后查阅