Mapa del catálogo: qué hay y cómo encontrarlo

Por: Artiko
agent-skillsplugins-de-agentesia-agentesgoogle-cloudgkebigquerygoogle-adscatalogo

Mapa del catálogo: qué hay y cómo encontrarlo

Este es el capítulo de consulta del curso. En los dos anteriores viste qué es google/skills y cómo instalarlo. Aquí tienes el inventario: los 103 skills que hoy contiene el repositorio, agrupados exactamente como los agrupa su README.md, con su ruta real en el árbol y una línea de qué resuelve cada uno.

Antes de nada, la advertencia que el propio repositorio pone en su primera pantalla:

[!NOTE] This repository is under active development.

Ese aviso es literal y cambia cómo debes leer lo que sigue. El catálogo no es una API estable: los skills se añaden, se renombran y se reorganizan. Trata este capítulo como una fotografía fiel de un momento concreto, y trata el comando ls skills/cloud de tu propio clon como la fuente de verdad del día en que lo ejecutes.

La forma del repositorio

El árbol de primer nivel es corto y no tiene sorpresas:

skills/
├── ads/        (12 skills)
├── analytics/  ( 2 skills)
└── cloud/      (89 skills)
plugins/
└── cloud/data-agent-kit/   (16 submódulos Git)
.claude-plugin/marketplace.json
.agents/plugins/marketplace.json
CONTRIBUTING.md
LICENSE          (Apache 2.0)
README.md

Solo existen tres áreas de primer nivel bajo skills/: ads, analytics y cloud. No hay skills/workspace/, ni skills/android/, ni skills/firebase/. Cada subdirectorio de un área contiene exactamente un SKILL.md, y el nombre del directorio coincide siempre con el campo name de su frontmatter: cero discrepancias en los 103 skills.

flowchart TD
    R[repo google slash skills] --> S[skills]
    R --> P[plugins]
    R --> M[manifiestos de marketplace]
    S --> C[cloud - 89 skills]
    S --> A[ads - 12 skills]
    S --> N[analytics - 2 skills]
    P --> D[data-agent-kit - 16 submodulos]
    M --> M1[.claude-plugin/marketplace.json]
    M --> M2[.agents/plugins/marketplace.json]

Dos taxonomías que no son la misma

Este es el punto que más confusión genera, y conviene fijarlo antes de leer las tablas.

El repositorio clasifica sus skills dos veces, de dos formas distintas:

  1. Las secciones del README.md. Son 12, y son las que verás al abrir el repositorio en GitHub. Es la taxonomía orientada al humano que busca.
  2. El campo metadata.category del frontmatter de cada SKILL.md. Son 17 valores distintos. Es la taxonomía orientada a la máquina que indexa.

No coinciden. La sección Infrastructure del README (23 skills) mezcla las categorías Containers, Networking, Storage y Compute. Y al revés: los dos skills de skills/analytics/ aparecen en el README bajo la sección Others, no bajo ninguna sección llamada “Analytics”.

Este es el reparto real por metadata.category, extraído del frontmatter:

metadata.categorySkills
AiAndMachineLearning18
Containers16
CloudObservabilityAndMonitoring13
GoogleAds12
MultiProductSolutions9
WellArchitectedFramework6
BigDataAndAnalytics5
Databases4
Security3
Storage3
Networking3
GettingStarted3
GoogleAnalytics2
Serverless2
CloudInfrastructureAndServices2
DevOps1
Compute1

Cuando cites una categoría, di cuál de las dos estás usando. Las tablas de este capítulo siguen la del README, porque es la que ve cualquiera que abra el repositorio.

El catálogo, sección por sección

Las 12 secciones del README, con su etiqueta literal, su ruta real y qué resuelve cada skill según su propia description.

Getting started with Google Cloud (3)

SkillRutaQué resuelve
Authenticating to Google Cloudskills/cloud/google-cloud-recipe-auth/Autenticación y autorización: usuarios humanos, identidades de servicio y Application Default Credentials.
Google Cloud Recipe: Foundation Builderskills/cloud/google-cloud-recipe-foundation-builder/Despliega una landing zone base para una organización: Organization Policies, jerarquía de carpetas y proyectos, facturación y logging centralizado.
Onboarding to Google Cloudskills/cloud/google-cloud-recipe-onboarding/Primeros pasos de un desarrollador: crear cuenta, configurar facturación, gestionar el proyecto y desplegar el primer recurso.

Los tres llevan metadata.category: GettingStarted. Aquí sección y categoría sí coinciden. El capítulo 5 los abre uno por uno.

Multi-product solution skills (9)

SkillRutaQué resuelve
Google Cloud solution-architecture workflowskills/cloud/google-cloud-solution-architecture/Descubre requisitos de una carga de trabajo de forma interactiva y genera recomendaciones de diseño multi-producto de extremo a extremo.
Agentic analytics across cloud providers and data typesskills/cloud/google-cloud-solution-agentic-analytics-spark-knowledge-catalog/Diseña analítica agéntica sobre datos repartidos entre Google Cloud, otros proveedores y on-premises.
Borderless open data lakehouse agentic AI systemskills/cloud/google-cloud-solution-agentic-ai-borderless-data-lakehouse/Diseña un data lakehouse abierto y gobernado con integración de agentes y consultas federadas entre nubes.
Build and deploy AI agents on Google Cloudskills/cloud/google-cloud-solution-build-deploy-agents/Flujo interactivo para diseñar, construir y desplegar agentes o sistemas multi-agente en Google Cloud.
Data science workflow with AI agents solutionskills/cloud/google-cloud-solution-agentic-ai-data-science-workflow/Arquitectura multi-producto para analítica de datos o cargas de ML basadas en agentes.
Live bidirectional multimodal streaming agentic AI solutionskills/cloud/google-cloud-solution-agentic-ai-bidirectional-streaming/Sistemas multi-agente que procesan flujos continuos multimodales para guía técnica en vivo y monitorización de seguridad.
Migrate AI Workloads to GKE Inferenceskills/cloud/google-cloud-solution-guided-gke-ai-migration/Migra cargas de inferencia existentes desde Cloud Run, la Gemini API o Agent Platform hacia inferencia autogestionada en GKE.
RAG for enterprise search using GKE and AlloyDBskills/cloud/google-cloud-solution-rag-enterprise-search-gke-sqldb/Búsqueda empresarial con RAG usando una base SQL con vectores como índice de embeddings.
Secure n-tier serverless web application with strict private application tiersskills/cloud/google-cloud-solution-n-tier-serverless-web-app/Aplicación web serverless de n capas con capas de aplicación estrictamente privadas.

Los nueve comparten un patrón propio: traen assets/ con una plantilla de salida y organizan su cuerpo por fases. El capítulo 6 los disecciona.

AI/ML (18)

SkillRutaQué resuelve
Agent Platform Alert Configurationskills/cloud/agent-platform-alert-configuration/Políticas de alerta con métricas OpenTelemetry para latencia, tasa de error, uso de tokens y calidad de agentes.
Agent Platform Endpoint Managementskills/cloud/agent-platform-endpoint-management/Crear, listar, describir, actualizar y borrar endpoints de servicio; y depurar errores de permisos, cuota o recurso ocupado.
Agent Platform Eval Flywheel Skillskills/cloud/agent-platform-eval-flywheel/Mide y mejora la calidad de modelos y agentes con la metodología Eval Quality Flywheel: datasets, métricas y comparación antes y después.
Agent Platform GenAI Inference Skillskills/cloud/agent-platform-inference/Genera código de inferencia contra modelos Gemini de primera parte y modelos OpenMaaS de terceros (Llama, DeepSeek, Qwen) usando el GenAI SDK, el SDK de OpenAI o el SDK heredado de Agent Platform.
Agent Platform Model Garden Deploy Skillskills/cloud/agent-platform-deploy/Despliega modelos abiertos o pesos propios desde Model Garden a endpoints, consulta el estado del despliegue y limpia recursos.
Agent Platform Model Registry Managementskills/cloud/agent-platform-model-registry/Subir, listar, describir, actualizar y borrar modelos y sus versiones en el Model Registry.
Agent Platform Model Tuningskills/cloud/agent-platform-tuning/Fine-tuning de modelos abiertos o Gemini sobre la infraestructura de Agent Platform.
Agent Platform Prompt Managementskills/cloud/agent-platform-prompt-management/Crear, listar, recuperar, versionar y borrar prompts gestionados.
Agent Platform RAG Engine Managementskills/cloud/agent-platform-rag-engine-management/Gestiona y consulta corpora del RAG Engine y recupera contextos con anclaje usando el GenAI SDK.
Agent Platform Troubleshootingskills/cloud/agent-platform-troubleshooting/Diagnostica fallos de Agent Gateway, Registry, Identity, Policies, Model Armor e IAP: 403 de egress no autorizado, 500 del Agent Runtime.
Agent Platform Tuning Managementskills/cloud/agent-platform-tuning-management/Listar, consultar y cancelar trabajos de tuning en curso.
BigQuery AI & MLskills/cloud/bigquery-ai-ml/SQL con las capacidades de ML y GenAI integradas en BigQuery: forecasting, anomalías, key drivers, búsqueda semántica y vectorial.
Gemini API in Agent Platformskills/cloud/gemini-api/Uso de la Gemini API sobre Agent Platform con el Google Gen AI SDK en Python, JS/TS, Go, Java y C#.
Gemini Enterprise Agent Platform - Managed Agents API Skillskills/cloud/gemini-agents-api/Crear, configurar, listar, actualizar y borrar recursos Agent gestionados por servidor, con ficheros, skills y tools montados.
Gemini Interactions API Skillskills/cloud/gemini-interactions-api/Interactions API con estado: conversaciones multi-turno, ejecución en segundo plano, streaming, salida estructurada y function calling.
LiveAPI Service Skillskills/cloud/gemini-live-api/Genera una clase cliente para el endpoint websocket de LiveAPI, con setup y reanudación de sesión y refresco de bearer token.
Migrating from Gemini API in AI Studio to Agent Platformskills/cloud/agent-platform-migrate-from-ai-studio/Guía la migración desde la Gemini API de AI Studio hacia Agent Platform, unificando IAM, facturación y observabilidad.
Skill Registryskills/cloud/agent-platform-skill-registry/Registra funcionalidad y descubre capacidades nuevas contra el Skill Registry de Agent Platform.

El capítulo 7 entra en este bloque.

Infrastructure (23)

SkillRutaQué resuelve
GKE AI/ML Inferenceskills/cloud/gke-inference/Despliega y optimiza inferencia en GKE con GPUs, TPUs y servidores de modelos.
GKE App Onboardingskills/cloud/gke-app-onboarding/Onboarding de una aplicación a GKE: contenerización, manifiestos de despliegue y migración.
GKE Backup & Disaster Recoveryskills/cloud/gke-backup-dr/Planes de backup de GKE y flujos de restauración.
GKE Basics & Critical Gotchasskills/cloud/gke-basics/Provisión de clústeres, credenciales de kubectl, Workload Identity y la decisión entre Autopilot y Standard.
GKE Batch & HPC Workloadsskills/cloud/gke-batch-hpc/Cargas batch y HPC con colas de trabajos y procesamiento paralelo.
GKE Cluster Autoscalerskills/cloud/gke-cluster-autoscaler/Autoescalado de nodos, aprovisionamiento automático de node pools y depuración de escalados que no ocurren.
GKE Cluster Creationskills/cloud/gke-cluster-creation/Creación de clústeres con plantillas predefinidas: Autopilot, Standard regional, GPU/AI Inference, AI Hypercompute.
GKE ComputeClassesskills/cloud/gke-compute-classes/Spot VMs con fallback a on-demand, targeting de aceleradores y depuración de pods pendientes.
GKE Golden Path Configurationskills/cloud/gke-golden-path/Valores por defecto de referencia y checklists de production readiness.
GKE JobSet Interruption Troubleshootingskills/cloud/gke-ai-troubleshooting-jobset-interruption/Bucles de reinicio de JobSet, preempción de Spot VMs y caídas del coordinador en entrenamiento.
GKE Manifest Generation Skillskills/cloud/gke-manifest-generation/Genera YAML de Kubernetes seguro y listo para producción, optimizado para Autopilot y Standard.
GKE Multi-Tenancyskills/cloud/gke-multitenancy/Aislamiento por namespace, RBAC por equipos, ResourceQuotas, LimitRanges y aislamiento de red.
GKE Networkingskills/cloud/gke-networking/Clústeres privados, VPC-native, DNS, egress de nodos, Dataplane V2 y planificación de rangos IP.
GKE Productionize Skillskills/cloud/gke-productionize/Revisión integral de production readiness: escalabilidad, seguridad, fiabilidad, observabilidad, backup/DR y coste.
GKE Reliabilityskills/cloud/gke-reliability/PodDisruptionBudgets, health probes y topology spread constraints.
GKE Service Networking Skillskills/cloud/gke-service-networking/Gateway API, Ingress, Cloud Armor, balanceo nativo de contenedores con NEGs, Private Service Connect y certificados gestionados.
GKE Storageskills/cloud/gke-storage/PVCs, PersistentVolumes, Filestore y GCS FUSE.
GKE Upgrades & Maintenanceskills/cloud/gke-upgrades/Planes de actualización, checklists previos y posteriores, runbooks de mantenimiento y estrategia de release channels.
GKE Workload Scalingskills/cloud/gke-workload-scaling/Horizontal Pod Autoscaler y Vertical Pod Autoscaler.
GKE Workload Troubleshooting Skillskills/cloud/gke-workload-troubleshooting/CrashLoopBackOff, OOMKilled, ImagePullBackOff y Pending, diagnosticados vía logs y eventos.
Google Cloud global external Application Load Balancer Configuration Skillskills/cloud/google-cloud-global-frontend-configuration/Proceso de descubrimiento en 6 pasos para diseñar y desplegar balanceadores globales con Cloud CDN, Cloud Armor y Service Extensions.
Google Cloud Networking Observability Expertskills/cloud/google-cloud-networking-observability/VPC Flow Logs, NAT, firewall, métricas de latencia y throughput, y Connectivity Tests.
Google Cloud Storage Basicsskills/cloud/google-cloud-storage-basics/Buckets y objetos: subida, descarga, signed URLs, control de acceso, clases de almacenamiento, versionado, CMEK y gcsfuse.

El capítulo 8 cubre GKE, Cloud Run y Firebase.

Databases and analytics (9)

SkillRutaQué resuelve
AlloyDB Basicsskills/cloud/alloydb-basics/Clústeres, instancias y backups de AlloyDB for PostgreSQL, con integración de sus tools MCP.
BigFrames (BigQuery DataFrame) basicsskills/cloud/bigquery-bigframes/Código Python con la API estilo pandas/scikit-learn sobre BigQuery.
BigQuery Asset Impact Analysisskills/cloud/datalineage-bigquery-asset-impact-analysis/Radio de impacto aguas abajo cuando una tabla o vista de BigQuery se rompe o cambia.
BigQuery Basicsskills/cloud/bigquery-basics/Datasets, tablas, vistas y jobs; consultas SQL e ingesta básica.
Bigtable Basicsskills/cloud/bigtable-basics/Diseño de row keys, column families, consultas SQL y diagnóstico de hotspotting.
Cloud SQL Basicsskills/cloud/cloud-sql-basics/Instancias y bases de datos MySQL, PostgreSQL y SQL Server gestionadas.
Data Lineage Summaryskills/cloud/datalineage-summary/Resume grafos de linaje de BigQuery y GCS como informe Markdown para depurar calidad de datos y procedencia.
Managed Service for Apache Airflow (formerly Cloud Composer) Migration Guideskills/cloud/managed-airflow-migrations/Migración de DAGs a Airflow 2.11.1 y Airflow 3, con patrones de escaneo de cambios incompatibles.
Spanner Basicsskills/cloud/spanner-basics/Instancias, bases de datos, diseño de claves primarias y diagnóstico de rendimiento.

El capítulo 9 trabaja este bloque.

Developer tools (3)

SkillRutaQué resuelve
Developer Device Platformskills/cloud/developer-device-platform-basics/Reserva dispositivos Android remotos, abre túneles de conexión y gestiona el estado y la expiración de sesiones.
gcloud CLI Skill for AI Agentsskills/cloud/gcloud/Validación de sintaxis, guardarraíles y reducción de salida para cualquier comando gcloud.
Google Agents CLI Onboardingskills/cloud/google-agents-cli-onboarding/Punto de entrada de agents-cli: crear, ejecutar en local, depurar, evaluar, desplegar y publicar un agente.

El skill gcloud merece una lectura aparte: abre con un bloque > [!CAUTION] titulado “MANDATORY PRE-CONDITION: EXPLICIT LEAF-LEVEL SYNTAX VALIDATION” y sostiene que el conocimiento previo del agente sobre gcloud es “stale and prone to hallucination”. El capítulo 4 lo disecciona.

Management tools (13)

SkillRutaQué resuelve
Cloud Monitoring Chart Generation Skillskills/cloud/cloud-monitoring-chart-generation/Genera textprotos de Widget y XyChart para la API de Dashboards a partir de consultas PromQL resueltas.
Configuring Cloud Loggingskills/cloud/cloud-logging-configuration-basics/Buckets regionales de logs, sinks, vistas, ocultación de logs sensibles en _Default, métricas basadas en logs y exclusiones.
Configuring Cross-Project Loggingskills/cloud/cloud-logging-cross-project-configuration/Enrutado de logs desde varios proyectos, carpetas u organizaciones a un bucket central.
Generate Logging Query Language queriesskills/cloud/cloud-logging-query-generation/Traduce lenguaje natural a consultas LQL, con filtrado por servicio de Google Cloud.
GKE Cost Analysisskills/cloud/gke-cost-analysis/Preguntas en lenguaje natural sobre coste de clústeres y cargas, contra exports de facturación en BigQuery.
GKE Cost Optimizationskills/cloud/gke-cost-optimization/Rightsizing de peticiones de CPU y memoria, Spot VMs, CUDs, cost allocation y cuotas.
GKE Observabilityskills/cloud/gke-observability/Cloud Logging, Cloud Monitoring y Prometheus gestionado en GKE.
GKE TPU Metrics Monitoring Guideskills/cloud/gke-tpu-metrics-monitoring/Duty cycle de TensorCore, memoria de TPU, disponibilidad de node pools multi-host y cálculo de MTTR y MTBI.
Handle Disruption on GPUs and TPUs Troubleshootingskills/cloud/gke-ai-troubleshooting-handle-disruption-gpu-tpu/Diagnostica, predice y mitiga interrupciones de nodo por mantenimiento de host en cargas con GPU y TPU.
Metric Selectionskills/cloud/cloud-monitoring-metric-selection/Localiza los descriptores de métrica relevantes para un servicio o recurso concreto.
SLO Alert Configuration Setup Wizardskills/cloud/google-cloud-slo-alert-configuration/Políticas de alerta de SLO basadas en PromQL para recursos registrados en App Hub, con salida en Terraform.
TPU Connection Failure and VBAR OOM Troubleshootingskills/cloud/gke-ai-troubleshooting-tpu-vbar-oom/Segfaults de vbar_control_agent, OOM y fallos de inicialización de dispositivo en nodos TPU v6e.
Workload Manager Basicsskills/cloud/workload-manager-basics/Evaluaciones, reglas, recursos escaneados y resultados de validación de Workload Manager.

Los trece llevan metadata.category: CloudObservabilityAndMonitoring, incluidos los tres de coste. Es un buen ejemplo de que la sección del README y la categoría del frontmatter cuentan historias distintas.

Well-Architected Framework (6)

SkillRutaQué resuelve
WAF Cost Optimizationskills/cloud/google-cloud-waf-cost-optimization/Recomendaciones de coste según el pilar de Cost Optimization del Well-Architected Framework.
WAF Operational Excellenceskills/cloud/google-cloud-waf-operational-excellence/Guía operativa según el pilar de Operational Excellence.
WAF Performance Optimizationskills/cloud/google-cloud-waf-performance-optimization/Guía de rendimiento según el pilar de Performance Optimization.
WAF Reliabilityskills/cloud/google-cloud-waf-reliability/Fiabilidad, resiliencia, redundancia, tolerancia a fallos y recuperación ante desastres.
WAF Securityskills/cloud/google-cloud-waf-security/Recomendaciones de IAM, red y seguridad según el pilar de Security.
WAF Sustainabilityskills/cloud/google-cloud-waf-sustainability/Impacto ambiental de la carga de trabajo según el pilar de Sustainability.

Las etiquetas del README son más largas: por ejemplo “Google Cloud Well-Architected Framework skill for the Security pillar”. Los seis son solo SKILL.md, sin references/, scripts/ ni assets/.

Security and identity (3)

SkillRutaQué resuelve
GKE Platform Securityskills/cloud/gke-platform-security/Endurecimiento a nivel de clúster: Secret Manager, RBAC, Binary Authorization, Shielded Nodes, GKE Sandbox e IAM.
GKE Workload Securityskills/cloud/gke-workload-security/Auditoría de clúster, Workload Identity Federation y Network Policies a nivel de aplicación y namespace.
SecOps Detection Coverage Skillskills/cloud/detection-engineering-coverage-evaluation/Flujo de detection engineering en Google SecOps: inteligencia de amenazas, eventos UDM sintéticos, cobertura de reglas y YARA-L 2.0.

Web and app hosting (2)

SkillRutaQué resuelve
Cloud Run Basicsskills/cloud/cloud-run-basics/Services para HTTP, jobs para tareas programadas o disparadas por eventos, y worker pools para procesamiento en segundo plano.
Firebase Basicsskills/cloud/firebase-basics/Instalación y login del CLI, creación y selección de proyecto, y descarga de google-services.json y GoogleService-Info.plist.

firebase-basics es la única skill de Firebase dentro de este catálogo. Trae 19 archivos en references/, incluidas guías de configuración por harness concreto: references/setup/claude_code.md, references/setup/antigravity.md, references/setup/gemini_cli.md, references/setup/cursor.md, references/setup/github_copilot.md.

Advertising (12)

SkillRutaQué resuelve
AI Migration Agent Instructions for the Google Mobile Ads SDKskills/ads/google-mobile-ads-android-migrate-to-next-gen/Migra apps Android del SDK GMA legado al Next-Gen, con tablas de mapeo de imports, clases y firmas.
Data Manager API Audience Ingestionskills/ads/data-manager-api-audience-ingestion/Añadir, eliminar y vaciar miembros de audiencia con la Data Manager API.
Data Manager API Event Ingestionskills/ads/data-manager-api-event-ingestion/Ingesta de eventos y conversiones offline por el endpoint /v1/events/ingest.
Data Manager API Setupskills/ads/data-manager-api-setup/Instalación de la librería cliente y configuración de autenticación de la Data Manager API.
Google Ads API Account Performance Diagnostics Skillskills/ads/google-ads-api-account-diagnostics/Diagnostica pérdida de conversiones, caída de leads y cuota de impresiones perdida por ad rank, pujas o presupuesto.
Google Ads API MCP Server Installationskills/ads/google-ads-api-mcp-setup/Descarga, configura e instala el servidor MCP oficial de Google Ads para conectarlo al asistente.
Google Ads API Quickstartskills/ads/google-ads-api-quickstart/Credenciales, elección entre 6 librerías cliente o REST, y errores típicos como USER_PERMISSION_DENIED o DEVELOPER_TOKEN_NOT_APPROVED.
Google Mobile Ads SDK - Banner Adsskills/ads/google-mobile-ads-banner/Banners en Android, iOS y Unity.
Google Mobile Ads SDK - Installskills/ads/google-mobile-ads-get-started/Integración inicial del SDK de GMA para AdMob o Ad Manager.
Google Mobile Ads SDK - Interstitial Adsskills/ads/google-mobile-ads-interstitial/Intersticiales en Android e iOS.
Google Mobile Ads SDK - Rewarded Adsskills/ads/google-mobile-ads-rewarded/Anuncios recompensados en Android e iOS.
IMA SDK basicsskills/ads/ima-sdk-basics/Inserción de anuncios de vídeo del lado cliente con VAST o VMAP en web, apps y TV.

skills/ads/ es la única correspondencia exacta del repositorio entre directorio, sección del README y metadata.category: los 12 skills de ads son la sección Advertising y llevan los 12 la categoría GoogleAds. El capítulo 10 entra aquí.

Others (2)

SkillRutaQué resuelve
Getting Started with Google Analytics Admin APIskills/analytics/google-analytics-admin-api-basics/Cuentas y propiedades, data streams, dimensiones personalizadas y eventos de conversión.
Getting Started with Google Analytics Data APIskills/analytics/google-analytics-data-api-basics/Informes con la Data API v1beta: métricas como activeUsers, dimensiones como city, y comprobación de compatibilidad.

Sí: la sección se llama literalmente Others, y contiene los dos únicos skills de skills/analytics/.

Cómo buscar el skill que necesitas

El README ordena, pero no busca. Con el repositorio clonado, estos son los comandos que resuelven el 90% de las preguntas.

Clona primero:

git clone https://github.com/google/skills.git
cd skills

Listar todo lo que existe, sin intermediarios:

ls skills/cloud skills/ads skills/analytics
find skills -name SKILL.md | wc -l    # 103 hoy

Buscar por tema en las descripciones, que es donde el agente decide si activar la skill:

grep -rl "Spot VM" skills --include=SKILL.md
grep -rl "signed URL" skills --include=SKILL.md
grep -ril "terraform" skills --include=SKILL.md

Filtrar por la categoría del frontmatter:

grep -rl "category: Databases" skills --include=SKILL.md
grep -rh "category:" skills --include=SKILL.md | sed 's/^ *//' | sort | uniq -c | sort -rn

Ojo con la indentación: google-cloud-storage-basics anida category: cuatro espacios en vez de dos, porque su bloque metadata incluye además version, publisher, tags y support_tier. Un grep '^ category:' demasiado estricto se lo salta y te devuelve 102 en vez de 103.

Leer solo la descripción de un skill, sin abrir el archivo entero:

sed -n '/^---$/,/^---$/p' skills/cloud/gke-basics/SKILL.md

Ver qué material extra trae un skill antes de decidir si te sirve:

find skills/cloud/gke-compute-classes -type f | sort

De los 103, 41 son solo SKILL.md, 55 traen references/, 17 traen assets/ y 12 traen scripts/. No existe ninguna otra carpeta convencional: no hay templates/, ni examples/, ni docs/, ni evals/.

Aprovechar las redirecciones cruzadas. El patrón de redacción de Google incluye casi siempre una frase de exclusión que te apunta al skill correcto. La de gke-basics es un ejemplo literal:

Manages core GKE cluster provisioning, credentials, Autopilot vs Standard selection,
and workload deployment. Use when creating GKE clusters, fetching kubectl credentials,
configuring Workload Identity, or deciding between Autopilot and Standard modes.
Don't use for specialized GKE networking (use gke-networking), advanced security hardening
(use gke-platform-security or gke-workload-security), or cluster upgrades (use gke-upgrades).

Si entraste por el skill equivocado, la propia descripción te da el nombre del correcto. La cláusula de exclusión aparece en 77 de las 103 descripciones, y 33 de ellas nombran además el skill alternativo. El capítulo 4 lo analiza como técnica de diseño, y el curso hermano de Agent Skills explica por qué la description es el único campo que el agente lee siempre.

flowchart TD
    Q[tengo un problema concreto] --> R[leo la seccion del README]
    R --> G[grep en las descripciones]
    G --> D{encuentro candidato}
    D -- si --> L[leo su description completa]
    D -- no --> E[reviso los repos externos de Google]
    L --> X{la frase de exclusion me redirige}
    X -- si --> Y[abro el skill que indica]
    X -- no --> Z[lo instalo y lo uso]

Tres trampas verificadas

Primera: hay nombres plausibles que no existen. El catálogo no tiene gke-security, ni gke-monitoring, ni cloud-functions-basics, ni vertex-ai-basics, ni pubsub-basics, ni firestore-basics. Si un nombre no aparece como directorio bajo skills/, no existe. La regla operativa es simple: antes de escribir el nombre de un skill, ejecuta ls skills/cloud | grep <algo>.

Segunda: cuatro descripciones redirigen a skills que no están en este repositorio. Son referencias colgantes reales, verificadas:

Skill que la mencionaNombre al que redirigeEstado
skills/ads/ima-sdk-basicsima-sdk-dai-basicsNo existe en google/skills
skills/cloud/agent-platform-deployvertex-deployNo existe en google/skills
skills/ads/google-ads-api-account-diagnosticsgma-android-integrateNo existe en google/skills
skills/cloud/cloud-monitoring-chart-generationcloud-monitoring-promql-queryNo existe en google/skills

El último caso es especialmente instructivo porque la misma frase cita dos nombres y solo uno es real: “use the cloud-monitoring-metric-selection or cloud-monitoring-promql-query skills”. El primero existe; el segundo no. Todas las demás redirecciones (use <skill>) apuntan a skills reales.

Tercera: el README y el árbol están sincronizados al 100%. Las 103 entradas del bloque <!-- BEGIN SKILLS --> corresponden a 103 rutas únicas, y hay 103 directorios con SKILL.md. Cero huérfanos en ambos sentidos. No puedes justificar una “skill mencionada pero no incluida”: si el README la lista, existe; si el árbol la tiene, está listada.

El README dedica una sección, Additional Google skills, a apuntar a otros repositorios. Son exactamente seis, y ninguno de sus skills cuenta dentro de los 103:

RepositorioURL
Flutter Skillshttps://github.com/flutter/skills
Dart Skillshttps://github.com/dart-lang/skills
Advanced Google Cloud Storage Skillshttps://github.com/gemini-cli-extensions/google-cloud-storage
Agent Development Kit (ADK) Skillshttps://github.com/google/agents-cli
Firestore Skillshttps://github.com/firebase/agent-skills/tree/main/skills/firebase-firestore
Genkit Skillshttps://github.com/genkit-ai/skills

Esto explica huecos que de otro modo parecerían arbitrarios: Flutter, Dart, Firestore y Genkit tienen skills oficiales de Google, pero no aquí. La única excepción es Firebase, que sí tiene skills/cloud/firebase-basics dentro del catálogo además del repositorio externo de Firestore.

Los plugins no son skills

Bajo plugins/cloud/data-agent-kit/ hay 16 directorios más, y es fácil confundirlos con skills. No lo son: son plugins que combinan skills y servidores MCP, referenciados como submódulos Git anclados a una versión concreta. Sus nombres aparecen en .claude-plugin/marketplace.json, cuyo campo name de nivel superior es google-plugins, el mismo que usas al instalar:

claude plugin marketplace add google/skills
claude plugin install <plugin>@google-plugins

Algunos de esos plugins son alloydb, bigquery, looker, spanner, dataproc, knowledge-catalog y oracledb. El capítulo 11 desarma el marketplace entero, y el curso hermano de Agent Plugins Spec explica el formato del manifiesto que hay detrás.

Para el conteo: 103 skills bajo skills/, 16 submódulos de plugin bajo plugins/. Son cosas distintas y se instalan de forma distinta.

Resumen

  • El catálogo tiene 103 skills: 89 en skills/cloud/, 12 en skills/ads/ y 2 en skills/analytics/. No hay más áreas.
  • Se clasifican dos veces: en 12 secciones del README y en 17 valores de metadata.category. No coinciden, y hay que decir cuál se está usando.
  • La sección más grande del README es Infrastructure con 23 skills; la categoría más grande del frontmatter es AiAndMachineLearning con 18.
  • skills/analytics/ aparece en el README bajo la sección Others, no bajo ninguna sección llamada “Analytics”.
  • El README y el árbol están sincronizados de forma biyectiva: 103 entradas, 103 rutas únicas, 103 SKILL.md, cero huérfanos.
  • Se busca con ls skills/* y grep -rl <tema> skills --include=SKILL.md. Las frases Don't use for X (use otra-skill) de las descripciones son el mejor índice de navegación que ofrece el repositorio.
  • Seis repositorios externos de Google alojan skills que no están aquí: Flutter, Dart, Cloud Storage avanzado, ADK, Firestore y Genkit.
  • El repositorio está marcado como under active development: verifica el inventario contra tu clon antes de apoyarte en él.

Siguiente: Anatomía de un skill de Google: disección de casos reales