Google Skills de 0 a Hero

Curso completo sobre google/skills, el catálogo oficial de Agent Skills que Google publica bajo licencia Apache 2.0 para sus propios productos: Google Cloud, Google Ads y Google Analytics.

No es un curso teórico sobre el formato SKILL.md. Es el curso que abre los archivos reales de un catálogo publicado por una empresa a escala industrial y explica qué hay dentro, por qué está escrito así y cómo lo aprovechas en tu propio flujo de trabajo.

Qué es google/skills

Un repositorio de GitHub con procedimientos ejecutables escritos en Markdown para que un agente los cargue cuando detecta que la tarea los necesita. No documentación de referencia: instrucciones prescriptivas con orden de pasos, comandos exactos, criterios de verificación y avisos sobre errores frecuentes.

Las cifras de la fotografía que usa este curso, contadas sobre el repositorio y no sobre el marketing:

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

find skills -name SKILL.md | wc -l   # 103
ls -d skills/cloud/*/     | wc -l    #  89
ls -d skills/ads/*/       | wc -l    #  12
ls -d skills/analytics/*/ | wc -l    #   2

Área del repositorio	Skills	Qué cubre
skills/cloud/	89	Google Cloud completo: fundamentos, soluciones, AI/ML, GKE, datos, observabilidad, seguridad
skills/ads/	12	Google Ads API, Data Manager API, Google Mobile Ads SDK, IMA SDK
skills/analytics/	2	Google Analytics Admin API y Data API
Total	103

El 86% del catálogo es Google Cloud. Y por dentro, cada SKILL.md declara un metadata.category propio que reparte esos 103 skills en 17 categorías distintas:

metadata.category	Skills
AiAndMachineLearning	18
Containers	16
CloudObservabilityAndMonitoring	13
GoogleAds	12
MultiProductSolutions	9
WellArchitectedFramework	6
BigDataAndAnalytics	5
Databases	4
Security, Networking, GettingStarted	3 cada una
Storage, Serverless, GoogleAnalytics, CloudInfrastructureAndServices	2 cada una
DevOps, Compute	1 cada una

Además de los skills, el repositorio trae un plugin empaquetado en plugins/cloud/data-agent-kit/ que agrupa 16 submódulos de Git, y dos manifiestos de marketplace paralelos: .claude-plugin/marketplace.json y .agents/plugins/marketplace.json.

Antes de empezar

Requisitos

• Un agente compatible con Agent Skills. Claude Code, Codex, Antigravity CLI o cualquier harness que lea el formato SKILL.md. Sin esto puedes leer el curso, pero no ejecutar nada.
• Una cuenta de Google Cloud para la parte práctica. La mayoría de los skills de skills/cloud/ ejecutan gcloud, bq o kubectl contra un proyecto real. Si solo quieres estudiar la estructura de los archivos, basta con clonar el repositorio.
• Manejo básico de terminal y Markdown. Todo el catálogo es Markdown con bloques de comandos; no hay build ni compilación.

No necesitas: saber Kubernetes, tener experiencia previa con Vertex AI ni haber escrito un skill antes. Cada capítulo explica el contexto del producto lo justo para entender qué está haciendo el skill.

Advertencia: esto está en desarrollo activo

El README.md del repositorio lo dice en su segunda línea:

Note This repository is under active development.

Eso significa exactamente lo que dice. Los 103 skills, los nombres de directorio y las secciones del índice del README son una fotografía, no un contrato. Cuando clones el repositorio, la primera comprobación que vale la pena hacer es esta:

find skills -name SKILL.md | wc -l

Si te devuelve un número distinto de 103, el catálogo se movió respecto a este curso. La estructura, los patrones de escritura y la forma de instalarlos siguen siendo válidos: lo que cambia es el inventario. Por eso el curso enseña también cómo contarlo y cómo buscarlo tú mismo en vez de pedirte que memorices listas.

Instalación en una línea

La vía corta, tal como la documenta el README:

npx skills add google/skills

Ese comando abre un selector interactivo para elegir qué skills instalar. El capítulo 2 cubre las cuatro vías oficiales —skills.sh, el marketplace de Claude Code, el de Codex y Antigravity CLI— más el camino manual que funciona en cualquier agente.

Ruta de aprendizaje

flowchart TD
    A[Fundamentos<br/>Cap. 1-4] --> B[El catalogo por dominio<br/>Cap. 5-10]
    B --> C[Empaquetado y practica<br/>Cap. 11-12]
    A --> A1[Que es, como se instala,<br/>que hay dentro]
    B --> B1[103 skills abiertos<br/>y agrupados por lo que resuelven]
    C --> C1[Plugins, marketplace,<br/>flujos reales y contribuir]

Capítulos

Fundamentos

Qué es el catálogo, cómo se instala, cómo se busca dentro de él y cómo están construidos sus archivos por dentro.

#	Capítulo	Qué cubre
1	Qué es google/skills y para qué sirve	Contenido real del repositorio, las cifras verificadas de los 103 skills, por qué Google publica procedimientos en vez de solo documentación, qué permite Apache 2.0 y los skills de Google que viven fuera de este catálogo
2	Instalación: skills.sh, Claude Code, Codex y Antigravity	Los cuatro instaladores del README, qué escribe cada uno y dónde, cómo comprobar que el agente descubrió el skill, instalar subconjuntos, actualizar, desinstalar y el camino manual
3	Mapa del catálogo: qué hay y cómo encontrarlo	Referencia de consulta: las secciones literales del README contra las rutas reales, las dos taxonomías que no coinciden, y las búsquedas con grep que te llevan al skill correcto
4	Anatomía de un skill de Google	Disección de cuatro skills de complejidad creciente: árbol, frontmatter, cuerpo, references/, scripts/, assets/; los patrones que Google repite y una plantilla copiable

El catálogo por dominio

Los 103 skills agrupados por lo que resuelven, con sus instrucciones reales abiertas sobre la mesa. Estos seis capítulos son consultables por separado: no hace falta leerlos en orden si solo te interesa un dominio.

#	Capítulo	Qué cubre
5	Skills de fundamentos: autenticación y onboarding	Los tres skills de GettingStarted: google-cloud-recipe-onboarding, google-cloud-recipe-auth como árbol de decisión y google-cloud-recipe-foundation-builder con la landing zone completa
6	Skills de soluciones multi-producto	Los 9 skills google-cloud-solution-*: qué arquitectura propone cada uno, el workflow compartido de cuatro fases y cómo elegir entre ellos
7	Skills de AI/ML y Agent Platform	Los 18 skills de la categoría más grande, ordenados por ciclo de vida: inferencia, tuning, registry y deploy, prompts, RAG Engine, eval flywheel, alertas y troubleshooting
8	Skills de infraestructura: GKE, Cloud Run y Firebase	Los 28 directorios gke-* más cloud-run-basics y firebase-basics: gotchas documentados, golden path y una sesión encadenada de código a Pod
9	Skills de datos y analítica	BigQuery y sus tres variantes, Data Lineage, bases gestionadas (AlloyDB, Cloud SQL, Spanner, Bigtable), Cloud Storage, migraciones de Airflow y los dos skills de Google Analytics
10	Skills de publicidad: Google Ads, Data Manager e IMA SDK	Los 12 skills de skills/ads/: migración a GMA Next-Gen, la cadena de Data Manager API, Google Ads API con su servidor MCP, los formatos del Mobile Ads SDK y el IMA SDK

Empaquetado y práctica

Cómo Google distribuye todo esto y cómo lo llevas a tu trabajo diario.

#	Capítulo	Qué cubre
11	Plugins y marketplace: cómo Google empaqueta y distribuye	Los dos manifiestos de marketplace campo por campo, el plugin data-agent-kit con sus 16 submódulos, la instalación desde cada harness y dónde termina el estándar y empieza la convención de producto
12	Integrarlos en tu flujo y contribuir al catálogo	Tres flujos end-to-end con skills reales, cuántos instalar sin saturar el descubrimiento, cómo fijar versiones y qué acepta el repositorio como contribución

La trilogía de cursos

Este curso es la tercera pieza de tres que cubren el mismo objeto desde alturas distintas. Los otros dos viven en este mismo sitio.

flowchart LR
    A[Agent Skills<br/>el formato] --> B[Agent Plugins Spec<br/>el empaquetado]
    B --> C[Google Skills<br/>la practica a escala]

Curso	Qué responde	Enlace
Agent Skills de 0 a Hero	Cómo se escribe un SKILL.md: frontmatter, la description que decide la activación, la carga progresiva de references/, los scripts ejecutables	Ir al índice
Agent Plugins Spec de 0 a Hero	Cómo skills, comandos y servidores MCP se agrupan en un plugin distribuible con su manifiesto y su marketplace	Ir al índice
Google Skills de 0 a Hero	Cómo se ve todo lo anterior cuando una empresa publica más de 100 skills de una vez y empaqueta plugins con versiones fijadas	Estás aquí

Orden recomendado

Si nunca escribiste un skill: empieza por Agent Skills. Ahí aprendes el formato y el mecanismo de activación. Vuelve aquí después: los capítulos 4 en adelante te van a resultar mucho más útiles cuando reconozcas cada campo del frontmatter y sepas por qué una description está escrita de esa forma.

Si ya escribes skills y quieres distribuirlos: haz Agent Skills → Agent Plugins Spec → este curso. El orden sigue la cadena natural del artefacto: primero el archivo, después el paquete, después el catálogo publicado.

Si vienes por Google Cloud y no por los agentes: puedes empezar directamente aquí. El capítulo 4 explica lo mínimo del formato para que entiendas las disecciones, y los capítulos 5 al 10 se leen como una guía de qué automatizó Google de su propia plataforma. Los cursos hermanos quedan como lectura posterior si decides escribir los tuyos.

Si solo necesitas resolver algo hoy: capítulo 2 para instalar, capítulo 3 para encontrar el skill, y el capítulo de dominio que corresponda.

Qué vas a saber hacer al terminar

Al cerrar el capítulo 12 vas a poder:

• Instalar el catálogo, entero o por partes, desde cualquiera de los cuatro caminos oficiales, y verificar que tu agente efectivamente descubrió los skills.
• Encontrar el skill correcto para una tarea concreta sin leer los 103, usando las secciones del README, la taxonomía de metadata.category y búsquedas con grep sobre el repositorio clonado.
• Leer un SKILL.md de Google y saber qué te está prometiendo: cuándo se dispara, qué comandos va a ejecutar, qué verifica al final y qué gotchas documentó el autor.
• Encadenar varios skills en una sesión real: fundamentos y autenticación, luego despliegue, luego observabilidad, luego la capa de IA, sabiendo cuál delega en cuál.
• Decidir cuántos instalar sin saturar el presupuesto de contexto de tu agente, y por qué instalar los 103 de golpe es contraproducente.
• Distinguir un skill de un plugin y leer un marketplace.json campo por campo, incluidas las diferencias entre el manifiesto de Claude Code y el de .agents/.
• Copiar los patrones de Google en tus propios skills: la estructura de encabezados que repiten, cómo separan references/ del cuerpo, cómo escriben los criterios de verificación y cómo formulan los tiers de confirmación en operaciones destructivas.
• Contribuir al repositorio sabiendo qué tipo de aporte acepta y por qué vía.

Skills de Google fuera de este catálogo

El propio README enlaza otros repositorios de Google que publican skills y que no forman parte de los 103. Si buscas algo de estos ecosistemas, el catálogo principal no lo tiene:

Ecosistema	Repositorio
Flutter	github.com/flutter/skills
Dart	github.com/dart-lang/skills
Cloud Storage avanzado	github.com/gemini-cli-extensions/google-cloud-storage
Agent Development Kit (ADK)	github.com/google/agents-cli
Firestore	github.com/firebase/agent-skills
Genkit	github.com/genkit-ai/skills

Los capítulos 1, 2, 3 y 9 vuelven sobre esta lista en el punto donde su ausencia se nota.

Cómo usar este curso

1. Lee los capítulos 1 al 4 en orden. Son el núcleo: sin ellos, los capítulos de dominio son listas de nombres sin contexto.
2. Del 5 al 10, ve al dominio que te importe. Cada uno es autoconclusivo y termina con su resumen y sus enlaces de instalación.
3. El 11 solo lo necesitas si vas a distribuir skills o si quieres entender por qué Google fija versiones con submódulos.
4. El 12 cierra con flujos completos y es el que más rinde si ya leíste los de dominio que te tocan.
5. Ten el repositorio clonado mientras lees. Todos los comandos de verificación del curso están pensados para ejecutarse sobre él, y son la forma de comprobar si el catálogo se movió desde esta fotografía.

Empieza por Qué es google/skills →