← Volver al listado de tecnologías ← Índice de Google Skills

Qué es google/skills y para qué sirve

6 de agosto de 2026 Por: Artiko

agent-skillsplugins-de-agentesia-agentesgoogle-cloudgkebigquerycatalogo-de-skills

Qué es google/skills y para qué sirve

Google tiene una de las bibliotecas de documentación técnica más grandes del mundo. Aun así, en enero de 2026 publicó un repositorio distinto: no más documentación, sino procedimientos operativos empaquetados para que un agente los cargue en contexto cuando la tarea lo pide.

Ese repositorio es github.com/google/skills. Contiene 103 Agent Skills para productos y tecnologías de Google, con un peso abrumador en Google Cloud. Este curso lo recorre entero: qué hay, cómo instalarlo, cómo están escritos esos skills por dentro y qué puedes copiar de ellos para tu propio catálogo.

Todo dato de este curso está verificado contra el repositorio real. Cuando nombremos un skill, su directorio existe. Cuando demos una cifra, sale de contar el árbol.

Qué es exactamente el repositorio

El README.md del repositorio lo define en dos líneas, sin adornos:

This repository contains Agent Skills for Google products and technologies, including Google Cloud.

Es un catálogo, no una herramienta. No hay un binario que instalar ni un servicio al que conectarse: hay 103 directorios, cada uno con un archivo SKILL.md y, opcionalmente, carpetas de apoyo. La estructura de primer nivel es esta:

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
README.md
CONTRIBUTING.md
LICENSE

Solo existen esas tres áreas bajo skills/. No hay skills/workspace/, ni skills/android/, ni skills/firebase/: los skills de Firebase viven dentro de skills/cloud/, igual que los de BigQuery o GKE.

El publicador es Google LLC. El manifiesto de marketplace lo declara así:

{
  "name": "google-plugins",
  "owner": {
    "name": "Google LLC"
  },
  "metadata": {
    "version": "0.0.1",
    "description": "A central repository of official skills and prescriptive plugins designed to provide a high-performance experience for building and deploying agentic applications across Google products and technologies."
  }
}

Fíjate en la palabra que eligieron: prescriptive. No describen, prescriben.

Por qué skills y no solo documentación

La diferencia entre un documento y un skill no es de formato. Es de momento de carga y de obligatoriedad.

Un documento está ahí para que alguien lo busque. Un skill se activa solo cuando la tarea coincide con su description, se inyecta en el contexto del agente y sus instrucciones pasan a ser reglas del turno, no sugerencias.

El caso más claro del catálogo es skills/cloud/gcloud/. Google conoce el problema: un modelo entrenado hace meses cree recordar la sintaxis de gcloud, y se la inventa. El skill abre con esta advertencia textual:

MANDATORY PRE-CONDITION: EXPLICIT LEAF-LEVEL SYNTAX VALIDATION

All pre-existing knowledge of gcloud commands, flags, flag values, and positional argument syntax is stale and prone to hallucination.

Y a continuación impone reglas que ninguna página de documentación podría imponer:

NEVER propose command parameters, output flag options, execute commands, OR outline step-by-step plans for any gcloud task before validating leaf-level syntax via gcloud help <command>.

Incluso prohíbe explícitamente una salida de escape:

FORBIDDEN Web Search Fallback: NEVER use search_web, web search, or external documentation search tools for gcloud CLI syntax. gcloud help <leaf_command> is the EXCLUSIVE authorized authority for command syntax.

Eso no es documentación. Es una política de ejecución que Google puede distribuir por Git y que el agente obedece sin que el usuario tenga que recordársela.

El flujo completo se ve así:

flowchart TD
    A[Usuario pide crear un cluster de GKE] --> B{El agente evalua<br/>las descriptions cargadas}
    B -->|coincide| C[Carga skills/cloud/gke-basics/SKILL.md]
    B -->|coincide| D[Carga skills/cloud/gcloud/SKILL.md]
    C --> E[Regla: por defecto Autopilot<br/>salvo requisito explicito]
    D --> F[Regla obligatoria:<br/>gcloud help antes de proponer sintaxis]
    E --> G[Plan y comando propuesto]
    F --> G
    G --> H[Ejecucion verificada]

Sin los skills, el paso B no existe: el agente responde con lo que cree recordar.

El contraste, en una tabla

Aspecto	Página de documentación	Skill del catálogo
Momento de uso	Cuando alguien la busca	Cuando la tarea activa su `description`
Destinatario	Persona	Agente
Naturaleza	Descriptiva	Prescriptiva y con prohibiciones
Carga en contexto	Manual, copiando y pegando	Automática y progresiva
Alcance	Explica el producto completo	Cubre un procedimiento acotado
Redirección	Enlaces de navegación	`Don't use for X, use otra-skill instead`

Esa última fila es el detalle más subestimado del catálogo. 77 de las 103 descripciones incluyen una cláusula que dice cuándo NO usar el skill, y 33 de ellas nombran explícitamente el skill al que saltar. Google no está publicando 103 documentos sueltos: está publicando una red enrutada donde cada nodo sabe delegar.

Ejemplo literal, de skills/cloud/gke-basics/SKILL.md:

description: >-
  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).

Tres redirecciones en una sola descripción, y los cuatro nombres citados existen como directorios reales. El capítulo 4 diseca esta fórmula en profundidad.

Las cifras reales del catálogo

No hay que creer en cifras redondas. El repositorio se cuenta:

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

Distribución por área

Directorio	Skills
`skills/cloud/`	89
`skills/ads/`	12
`skills/analytics/`	2
Total	103

El 86% del catálogo es Google Cloud. Los otros dos bloques son publicidad —Google Ads API, Data Manager API, Google Mobile Ads SDK e IMA SDK— y dos skills de Google Analytics.

Distribución por categoría del frontmatter

Cada SKILL.md declara un metadata.category. Extraerlos da la taxonomía interna real:

grep -rh '^  category:' skills/ | sort | uniq -c | sort -rn

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

Son 17 categorías. El README.md, en cambio, agrupa los mismos 103 skills en 12 secciones distintas: Getting started with Google Cloud, Multi-product solution skills, AI/ML, Infrastructure, Databases and analytics, Developer tools, Management tools, Well-Architected Framework, Security and identity, Web and app hosting, Advertising y Others.

Dos taxonomías paralelas sobre el mismo conjunto. No coinciden: la sección Infrastructure del README, con 23 skills, mezcla las categorías Containers, Networking, Storage y Compute. El capítulo 3 desenreda ese doble mapa y explica cuál conviene usar para buscar.

Distribución por estructura de archivos

Métrica	Valor
Skills que son solo `SKILL.md`, sin archivos extra	41
Skills con carpeta `references/`	55
Skills con carpeta `assets/`	17
Skills con carpeta `scripts/`	12
Archivos totales en `references/`	289
Archivos totales en `scripts/`	58
Archivos totales en `assets/`	46

Dos lecturas concretas de esta tabla.

La primera: 40% del catálogo es un único archivo Markdown. Un skill útil no necesita infraestructura. Si estás empezando tu propio catálogo, esta es la barrera de entrada real.

La segunda: los tres únicos nombres de subcarpeta usados en los 103 skills son references/, scripts/ y assets/. No hay templates/, ni examples/, ni docs/, ni evals/. Esos tres nombres no son obligatorios en el estándar Agent Skills —la especificación solo exige el SKILL.md— pero sí son la convención que recomienda su guía de autoría, y Google se ciñó a ella sin inventar variantes.

Un skill con las tres carpetas se ve así en disco:

skills/cloud/bigtable-basics/
├── SKILL.md
├── assets/
│   └── row_key_schema.yaml
└── references/
    ├── cli_data_access.md
    ├── client_libraries.md
    ├── dataplex.md
    ├── infrastructure_management.md
    ├── schema_design.md
    └── sql_guide.md

El SKILL.md queda corto y enruta hacia los archivos de references/ según lo que la tarea necesite. Es carga progresiva aplicada de forma literal: el agente lee el índice, decide, y solo entonces abre schema_design.md.

Un caso extremo del catálogo es skills/cloud/cloud-logging-query-generation/, con 22 archivos de referencia: veintiuno son un query_<servicio>.md —query_gke.md, query_bigquery.md, query_cloud_run.md, query_audit_logs.md…— y el restante es un api_reference.md. Y el SKILL.md no deja la elección al azar:

Before generating a query, you MUST read the examples for the specific service.

Ese es el patrón que el capítulo 4 desmonta pieza por pieza.

Licencia Apache 2.0: qué puedes hacer con esto

El archivo LICENSE del repositorio es la Apache License 2.0 completa, 202 líneas. El README.md la resume sin ambigüedad:

You are free to copy, modify, and distribute these skills under the terms of the Apache 2.0 license.

En términos prácticos, y sin que esto sea asesoría legal:

Puedes	Condición
Copiar cualquier skill a tu repositorio interno	Conservar el aviso de licencia y copyright
Modificarlo para tu organización	Marcar de forma destacada los archivos que cambiaste
Redistribuirlo, incluso comercialmente	Incluir una copia de la licencia Apache 2.0
Usarlo dentro de un producto propietario	La licencia no obliga a liberar tu producto

Lo que la licencia no te da: derechos sobre las marcas de Google. Puedes reutilizar el contenido del skill; no puedes presentar tu fork como producto oficial de Google ni usar sus marcas para promocionarlo.

Y trae una concesión de patentes explícita, con su contrapartida: si demandas a alguien alegando que este software infringe una patente tuya, tus derechos bajo esta licencia terminan.

Para un equipo de plataforma, esto convierte al catálogo en algo más que referencia. Es materia prima legalmente reutilizable: puedes tomar skills/cloud/gke-manifest-generation/, adaptar sus reglas a tus políticas de seguridad internas y publicarlo en tu marketplace privado. El capítulo 12 detalla ese flujo.

Advertencia: esto está en movimiento

El README.md lleva un aviso destacado desde el principio:

[!NOTE] This repository is under active development.

No es una fórmula vacía. El manifiesto de marketplace declara "version": "0.0.1". Las cifras de este curso —103 skills, 17 categorías, 12 secciones— son una fotografía verificada, no una constante. Skills nuevos aparecerán, algunos se renombrarán y otros se fusionarán.

Trátalo en consecuencia:

Fija una versión. Si dependes de estos skills en producción, ancla un commit o una release en lugar de seguir main.
Verifica antes de citar. Un nombre de skill que parece obvio puede no existir. gke-security suena razonable; el repositorio tiene gke-platform-security y gke-workload-security, y ningún gke-security.
Revisa los cambios al actualizar. Una description que cambia altera cuándo se activa el skill, y eso modifica el comportamiento de tu agente sin que hayas tocado una línea de tu código.

Hay una segunda restricción que conviene conocer desde el día uno. El CONTRIBUTING.md es tajante:

At this time, we are not accepting external pull requests or code contributions.

El motivo declarado: todo skill pasa por “a rigorous internal verification and approval process by Google teams”. Lo que sí aceptan es reportar issues, solicitar skills nuevos y —textualmente— hacer fork y remix:

Remix & Share: You are encouraged to fork this repository and remix these skills for your own specialized workflows.

Es decir: el canal para mejorar el catálogo oficial es el issue tracker; el canal para adaptarlo a tu realidad es tu propio fork. El capítulo 12 trabaja ambos.

Skills de Google que no están aquí

El propio README.md reconoce que este catálogo no agota los skills de Google. Su sección Additional Google skills enlaza a seis repositorios externos:

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

Detalle que ahorra confusiones: google-cloud-storage aparece en esa lista de repositorios externos y además existe skills/cloud/google-cloud-storage-basics/ dentro del catálogo. Son cosas distintas: el skill interno cubre lo básico de buckets y objetos; el repositorio externo cubre escenarios avanzados.

Aparte de los skills, el repositorio empaqueta plugins: combinaciones de skills y servidores MCP referenciadas como submódulos Git bajo plugins/cloud/data-agent-kit/. Son 16, cada uno anclado a una versión concreta: alloydb en 0.2.0, spanner en 0.3.1, looker en 0.3.5, knowledge-catalog en 0.5.2, entre otros. El capítulo 11 los recorre y explica por qué Google los distribuye por submódulo en vez de incluirlos en el árbol.

Dónde encaja este curso

Este es el tercer curso de una trilogía. Cada uno responde una pregunta distinta sobre el mismo objeto:

flowchart LR
    A[Agent Skills<br/>Como se escribe un SKILL.md] --> C[Google Skills<br/>Como se ve a escala real]
    B[Agent Plugins Spec<br/>Como se empaqueta y distribuye] --> C
    C --> D[Tu propio catalogo<br/>interno]

Agent Skills enseña el formato: el frontmatter, la description, la carga progresiva, los scripts, la especificación. Es el cómo se escribe.
Agent Plugins Spec enseña el empaquetado: manifiestos, marketplaces, distribución. Es el cómo se reparte.
Este curso es el cómo se ve aplicado a escala real: más de cien skills publicados por una empresa que los usa en serio, con sus patrones, sus inconsistencias y sus decisiones de diseño a la vista.

No necesitas haber hecho los otros dos para seguir este. Sí ayuda: cuando lleguemos al capítulo 4 y disequemos por qué skills/cloud/agent-platform-alert-configuration/ reparte 26 archivos entre references/ y scripts/, la lógica se entiende mejor si ya sabes qué es la carga progresiva.

En la dirección inversa, este curso funciona como banco de pruebas: cada regla que enseña la especificación aparece aquí aplicada, y a veces contradicha. Por ejemplo, la especificación sugiere un orden de claves en el frontmatter; en el catálogo, 67 skills usan name → metadata → description y 36 usan name → description → metadata. Ver esas grietas en un catálogo oficial dice más sobre qué importa de verdad que cualquier guía de estilo.

Cómo está organizado este curso

Doce capítulos en tres bloques.

Bloque 1: entrar al catálogo — qué es, cómo instalarlo, cómo encontrar cosas en él y cómo están construidos sus skills por dentro.

#	Capítulo
1	Qué es google/skills y para qué sirve (este capítulo)
2	Instalación: skills.sh, Claude Code, Codex y Antigravity
3	Mapa del catálogo: qué hay y cómo encontrarlo
4	Anatomía de un skill de Google: disección de casos reales

Bloque 2: recorrido por dominios — los 103 skills agrupados por lo que resuelven, con sus instrucciones reales sobre la mesa.

#	Capítulo
5	Skills de fundamentos: autenticación y onboarding en Google Cloud
6	Skills de soluciones multi-producto: arquitecturas completas
7	Skills de AI/ML y Agent Platform
8	Skills de infraestructura: GKE, Cloud Run y Firebase
9	Skills de datos y analítica
10	Skills de publicidad: Google Ads, Data Manager e IMA SDK

Bloque 3: llevarlo a tu trabajo — el empaquetado en plugins y cómo integrar o adaptar todo esto.

#	Capítulo
11	Plugins y marketplace: cómo Google empaqueta y distribuye
12	Integrarlos en tu flujo y contribuir al catálogo

Qué necesitas

Para leer el curso, nada más que un navegador. Para seguirlo con las manos:

git clone https://github.com/google/skills
cd skills
find skills -name SKILL.md | wc -l

Si ese comando responde un número distinto de 103, el catálogo ya cambió respecto a esta fotografía. Es exactamente lo que espera un repositorio under active development.

Para instalar y ejecutar los skills necesitarás además un agente compatible —Claude Code, Codex, Antigravity CLI o cualquiera que soporte el formato— y, para los de Google Cloud, una cuenta con gcloud configurado. El capítulo 2 cubre las cuatro vías de instalación oficiales, exactamente como las documenta el README.md.

Resumen

github.com/google/skills es el catálogo oficial de Agent Skills de Google: 103 skills repartidos en skills/cloud/ con 89, skills/ads/ con 12 y skills/analytics/ con 2.
Publica procedimientos prescriptivos, no documentación. El skill gcloud declara que el conocimiento previo del modelo es “stale and prone to hallucination” y obliga a validar con gcloud help antes de proponer cualquier comando.
El catálogo es una red enrutada: 77 de las 103 descripciones dicen explícitamente cuándo NO usar el skill, y 33 nombran el skill al que redirigir.
Convive con dos taxonomías: 17 valores de metadata.category en el frontmatter y 12 secciones en el README.md, que no se corresponden entre sí.
41 skills son un único archivo SKILL.md. Los tres únicos nombres de subcarpeta usados son references/, scripts/ y assets/.
La licencia Apache 2.0 permite copiar, modificar y redistribuir, conservando avisos, marcando los cambios e incluyendo la licencia. No cede derechos de marca.
El repositorio está under active development y CONTRIBUTING.md declara que no se aceptan pull requests externos: el canal es el issue tracker, y el fork está explícitamente fomentado.
Existen seis repositorios de skills de Google fuera de este catálogo —Flutter, Dart, Cloud Storage avanzado, ADK, Firestore y Genkit— más 16 plugins distribuidos como submódulos bajo plugins/cloud/data-agent-kit/.

Siguiente: Instalación: skills.sh, Claude Code, Codex y Antigravity