google/skills: las habilidades oficiales de Google para agentes de código

Un repositorio de «Agent Skills» (habilidades para agentes de código) mantenido por Google, que empaqueta conocimiento de dominio de Google Cloud, Firebase, Google Ads, Analytics y otras tecnologías en instrucciones Markdown que los agentes de programación pueden cargar bajo demanda.

Qué es

google/skills es el repositorio oficial de Agent Skills de Google para sus productos y tecnologías. No es una aplicación, ni un modelo, ni un servidor: es una colección de skills —carpetas con un archivo SKILL.md (metadatos más instrucciones) opcionalmente acompañadas de scripts, referencias y plantillas— que un agente de código puede cargar cuando una tarea encaja con su descripción.

El README declara explícitamente que el repositorio «está en desarrollo activo» y que contiene habilidades para productos de Google, incluidas Google Cloud. La instalación base documentada es npx skills add google/skills, con una lista de selección para instalar solo las habilidades deseadas.

A diferencia de un plugin tradicional que inyecta una gran cantidad de contexto, el formato de skills carga la información bajo demanda: el agente lee la descripción de cada skill y solo profundiza cuando corresponde, lo que reduce la expansión del contexto (context bloat).

Origen

El proyecto arrancó como un esfuerzo interno de Google llamado «swarm» (una fuerza de tarea cruzada de Developer Advocates y Technical Writers) que se intensificó de cara a Google Cloud Next 2026, con el objetivo de empaquetar el conocimiento de dominio de Google Cloud en instrucciones legibles por agentes.

El anuncio público se produjo el 22 de abril de 2026, el Día 1 de Google Cloud Next 2026, por Megan O’Keefe (Senior Staff Developer Advocate) en el blog oficial de Google Cloud: «Level Up Your Agents: Announcing Google’s Official Skills Repository». En ese lanzamiento el repositorio arrancaba con trece habilidades, centradas en tecnologías de Google Cloud (AlloyDB, BigQuery, Cloud Run, Cloud SQL, Firebase, Gemini API y GKE), tres habilidades de pilares Well-Architected (Seguridad, Fiabilidad y Optimización de costes) y tres «recetas» (onboarding, autenticación y observabilidad de red).

Lanzamiento de google/skills en el keynote de Google Cloud Next 2026: trece habilidades iniciales

El relato oficial también da una motivación técnica clara: los agentes ya pueden conectarse a fuentes de información en tiempo real mediante servidores MCP, pero el uso intenso de MCP produce «context bloat» (cargas enormes de contexto que confunden al modelo y disparan el coste de tokens). Las habilidades son la respuesta: «documentación compacta, orientada al agente, para una tecnología o tarea concreta» que el agente carga solo cuando la necesita.

Un segundo artículo, «Behind the scenes: How we build, test, and scale Google Agent Skills» (por Remigiusz Samborski, Lead Developer Relations Engineer), describe cómo el equipo construye, evalúa y gobierna las habilidades: validación interna antes de la publicación, exportación automatizada a GitHub, controles de CI/CD y evaluaciones continuas.

Filosofía y principios

El README y los artículos de blog dejan constancia de varios principios verificables:

Conocimiento empaquetado y bajo demanda. Cada skill es documentación procedimental compacta que el agente carga solo cuando la tarea encaja con su descripción, para reducir el bloat de contexto.

Carga de conocimiento bajo demanda: el agente compara contexto sobrecargado frente a contexto optimizado

Preferencia por herramientas MCP remotas. El principio rector de diseño declarado es: «Referencia herramientas MCP remotas siempre que sea posible, cayendo a llamadas CLI o API solo cuando sea necesario». Los servidores MCP remotos aportan herramientas, autenticación y gobernanza IAM de forma integrada.

Servidores MCP remotos como puentes seguros: herramientas, autenticación e IAM integrados

Calidad y gobernanza estrictas. Antes de que una skill entre en el repositorio debe superar un pipeline de CI/CD: linters (metadatos de frontmatter, recuento de líneas, disposición de directorios y convenciones de nomenclatura), verificadores de enlaces (para eliminar 404 y enlaces alucinados antes del merge) y listas de comprobación asistidas por IA.

Pipeline de calidad CI/CD: linters, verificadores de enlaces y aprobación interna antes del merge

Evaluaciones continuas. Las skills se evalúan «on-submit» (los autores deben aportar conjuntos de prompts de evaluación y rúbricas) y semanalmente. Se comparan agentes con y sin cada skill en dos dimensiones —precisión y eficiencia (tokens y tiempo)— y se ejecutan varias veces contra distintos frameworks de agentes para obtener resultados estadísticamente significativos.

Evaluación continua de las skills: comparación con y sin skill, precisión, tokens y latencia

Las habilidades son productos, no fragmentos. Hay reglas estrictas de propiedad: los mantenedores del repo supervisan la salud del repositorio y los pipelines, y los skill owners son responsables del mantenimiento a largo plazo de cada habilidad (por ejemplo, cuando cambia una API de producto).
Gobernanza cerrada a contribuciones externas. El repositorio no acepta solicitudes de cambios (PR) externas: todas las skills deben superar un proceso interno de verificación y aprobación de los equipos de Google.

Cómo funciona

La estructura canónica de cada skill (según la especificación de agentskills.io a la que el README remite) es una carpeta con:

SKILL.md (obligatorio): metadatos YAML (mínimo name y description) más las instrucciones en Markdown.
scripts/, references/, assets/ (opcionales): código ejecutable, documentación de referencia y plantillas o recursos.

Anatomía de una skill: SKILL.md, scripts, referencias y assets como cartuchos de datos modulares

El campo description del frontmatter describe qué hace la skill y cuándo usarla, y muchas skills del repositorio lo amplían con una cláusula de «no usar para…», que dirige al agente hacia la skill adecuada (por ejemplo, gke-basics dice «no usar para networking especializado (use gke-networking)»).

Las 114 habilidades presentes en la rama main se organizan en tres categorías de primer nivel dentro de skills/: cloud (99), ads (13) y analytics (2). A su vez, skills/cloud/ se subdivide en grupos temáticos visibles en el README: inicio y onboarding, soluciones multi-producto, IA/ML, infraestructura (un gran bloque dedicado a GKE), bases de datos y analítica, herramientas de desarrollo, herramientas de gestión, marco Well-Architected, seguridad e identidad, y alojamiento web.

Además de las skills, el repositorio agrupa plugins (skills + servidores MCP) para «agent harnesses» (arañas de agentes) en la carpeta plugins/ y en .claude-plugin/marketplace.json. El archivo marketplace.json define un marketplace llamado google-plugins (propietario «Google LLC», versión 0.0.1) que expone 16 plugins (AlloyDB, Bigtable, Cloud SQL MySQL/PostgreSQL/SQL Server, Firestore, Data Agent Kit, Google Cloud Storage, Looker, OracleDB, Spanner, Knowledge Catalog, Dataproc, BigQuery y db-context-engineering), varios de ellos resueltos como submódulos git que apuntan a repositorios gemini-cli-extensions/* con etiquetas de versión.

La instalación documentada varía por arnés:

Arnés	Instalación
Genérico (skills.sh)	`npx skills add google/skills`
Claude Code	`claude plugin marketplace add google/skills`, luego `claude plugin install <plugin>@google-plugins`
Codex	`codex plugin marketplace add google/skills`, luego instalar desde el navegador `/plugins`
Antigravity CLI	`agy plugin install https://github.com/google/skills/<plugin-path>`

El ecosistema

El repositorio enlaza explícitamente, en su sección «Additional Google skills», a una familia de repositorios de habilidades oficiales de Google y de los ecosistemas que orbitan:

gemini-cli-extensions/google-cloud-storage — habilidades oficiales de Google Cloud Storage (gestión de cubos y objetos, transferencia de datos, MCP, IAM, seguridad, ciclo de vida, gcsfuse y Terraform); 23 estrellas, 2 bifurcaciones.
google/agents-cli — «Agent Development Kit (ADK) Skills», el CLI y skills que convierten a cualquier asistente de código en experto en crear, evaluar y desplegar agentes en Google Cloud; 5.713 estrellas, 622 bifurcaciones.
android/skills — habilidades para Android; 6.940 estrellas, 440 bifurcaciones.
dart-lang/skills — habilidades para Dart; 456 estrellas, 33 bifurcaciones.
firebase/agent-skills — «Agent Skills for Firebase»; 421 estrellas, 85 bifurcaciones.
flutter/skills — el README enlaza a github.com/flutter/skills, que redirige a flutter/agent-plugins; 2.871 estrellas.
genkit-ai/skills — habilidades que enseñan a los agentes a construir aplicaciones con el framework Genkit (JS/TS, Go, Dart); 26 estrellas, 6 bifurcaciones.
googlemaps/agent-skills — habilidades de Google Maps Platform; 27 estrellas, 8 bifurcaciones.

Mapa del ecosistema de skills de Google: android, dart, flutter, firebase, genkit, maps y el marketplace google-plugins

Además, los plugins de google/skills consumen por submódulo una serie de repositorios gemini-cli-extensions/* (alloydb, alloydb-omni, bigquery-data-analytics, cloud-sql-*, data-agent-kit-starter-pack, dataproc, firestore-native, google-cloud-storage, knowledge-catalog, looker, oracledb, spanner) y GoogleCloudPlatform/* (cloud-bigtable-ecosystem, db-context-enrichment). En la práctica, google/skills actúa como un punto de agregación oficial de las habilidades de Google Cloud, mientras que cada ecosistema (Android, Dart, Flutter, Firebase, Genkit, Maps) mantiene el suyo.

Estas cifras son las que devolvió la API de GitHub durante esta investigación (25 de agosto de 2026); no constituyen una auditoría de calidad ni compatibilidad de cada derivado.

Estado oficial / semioficial

Este repositorio tiene un estatus oficial directo: está alojado bajo la organización de Google en GitHub, fue anunciado como «Google’s official skills repository» por Google Cloud el 22 de abril de 2026 en el marco de Google Cloud Next 2026, y el archivo marketplace.json declara su propietario como «Google LLC».

En la práctica, esto significa tres cosas verificables:

Es el punto de entrada oficial de Google para dar a los agentes de código conocimiento de dominio de sus productos, no una iniciativa comunitaria.
Las skills están validadas internamente y exportadas de forma automatizada, lo que le da el peso de una garantía de calidad y actualizaciones por parte de Google.
Actúa como referencia de facto del formato «Agent Skills» dentro del ecosistema de Google (junto a los repositorios de skills de Android, Dart, Flutter, Firebase, Genkit y Maps), y se apoya en la especificación abierta de agentskills.io.

No se encontró en las fuentes consultadas una designación formal de «estándar» por un organismo externo; su oficialidad es la de un proveedor (Google), no la de un consorcio.

Guía rápida de uso

Instalación y primer arranque

El método genérico documentado en el README es:

npx skills add google/skills

Arranque rápido por línea de comandos: npx skills add google/skills y rutas de instalación por arnés

Desde el comando de instalación se puede seleccionar qué skills específicas del repositorio se quieren instalar en lugar de todas. Los prerequisitos son los del propio agente de código en el que se van a cargar las habilidades (por ejemplo, Claude Code, Codex o Antigravity CLI) y, para que las skills de Google Cloud sean útiles, un entorno autenticado contra Google Cloud (gcloud auth login).

Para los arneses de agentes concretos:

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

# Codex
codex plugin marketplace add google/skills
# y luego instalar desde el navegador de /plugins

# Antigravity CLI
agy plugin install https://github.com/google/skills/<plugin-path>

En el primer arranque, el agente obtiene un conjunto de skills visibles en su contexto de capacidades; a partir de ahí, la activación es automática según la descripción de cada skill (no hay que invocar la skill a mano).

Flujos de trabajo habituales

Para empezar con Google Cloud (cuenta, facturación, proyecto y primer recurso), el agente aplica la skill google-cloud-recipe-onboarding, que documenta una «happy path» no interactiva: comprobar entorno, autenticarse con gcloud auth login, seleccionar o crear un proyecto, enlazar la cuenta de facturación y desplegar el primer recurso.
Para operar con gcloud, la skill gcloud obliga al agente a validar la sintaxis a nivel de subcomando con gcloud help <comando_hoja> antes de proponer o ejecutar cualquier comando, y prohíbe usar búsqueda web para la sintaxis de gcloud. El resultado es una propuesta de comando validada, no inventada.
Para provisionar un clúster GKE, la skill gke-basics dirige la decisión Autopilot vs. Standard y aplica reglas críticas (por ejemplo, --enable-private-nodes y --enable-private-endpoint para clústers privados, y la anotación de Workload Identity iam.gke.io/gcp-service-account en lugar de montar claves JSON de Service Account en los pods).
Para trabajar con datos, skills como bigquery-basics, bigquery-ai-ml o el plugin data-agent-kit permiten diseñar pipelines, transformar datos con dbt y escribir notebooks Spark/BigQuery SQL desde el agente.

Configuración esencial

SKILL.md de cada skill — el archivo central (metadatos name/description + instrucciones). Es lo que el agente lee para decidir si aplica la skill.
El campo description del frontmatter — define el disparo de la skill («use when…» / «don’t use for…»). Ajustarlo es la principal palanca para afinar cuándo el agente aplica o evita una skill.
plugins/ y .claude-plugin/marketplace.json — el catálogo de plugins (skills + MCP) que se instala por arnés de agente.
El arnés de agente elegido (Claude Code / Codex / Antigravity CLI) — determina el comando de instalación y el mecanismo de activación.
La autenticación de Google Cloud (gcloud / IAM) — requisito para que las skills de infraestructura, base de datos y gestión funcionen de verdad.

Trampas frecuentes y soluciones

No se aceptan PR externas. Si intentas contribuir código, el proceso es abrir un issue (bugs, inexactitudes o patrones de seguridad anti-patrón) o solicitar una skill nueva; la contribución directa de código no está permitida. La vía abierta para experimentar es hacer fork del repositorio y remezclar las skills para flujos propios.
El repositorio no tiene releases/tags públicos con notas de versión agregadas (la API de releases devuelve lista vacía). El «estado» de las skills se sigue a través de los commits (rótulos del equipo «Cloud IX Team») y del CHANGELOG implícito del README, no de un tag semántico único.
Las skills de gcloud pueden parecer estrictas. La obligación de validar con gcloud help <leaf> antes de cada comando y la prohibición de búsqueda web son intencionales (para evitar sintaxis alucinada), pero ralentizan flujos rápidos; es un comportamiento documentado, no un fallo.
Las skills cambian con frecuencia. Las evaluaciones semanales y la naturaleza «en desarrollo activo» implican que una skill puede cambiar entre versiones; conviene fijar el arnés y verificar la skill concreta si se depende de un comportamiento estable.

Integraciones y migración

MCP. El principio de diseño es preferir herramientas MCP remotas; las skills se combinan con servidores MCP (autenticación e IAM integrados). El repositorio también expone plugins que agrupan skills + MCP.
Agent harnesses. Se integra con Claude Code, Codex y Antigravity CLI a través de sus mecanismos de marketplace/plugin, y de forma genérica vía skills.sh / npx skills.
Migración. Al ser un repositorio de instrucciones (no de estado), «migrar» significa simplemente instalarlo en el agente de destino y dejar que el formato Agent Skills sea interpretado por el arnés. No hay datos de usuario que portar.

Números del repo

Medición: 25 de agosto de 2026, API de GitHub.

Métrica	Valor
Estrellas	18.682
Bifurcaciones	1.493
Incidencias abiertas indicadas por la API	35
Commits (rama main)	277
Lenguaje principal	Python (también Shell, HCL, Go Template, JavaScript, Dockerfile)
Licencia	Apache-2.0
Creación	31 de marzo de 2026
Último push	24 de agosto de 2026

Los principales contribuidores que devolvió la API, por número de contribuciones, fueron cloud-ix-copybara (242, una cuenta automatizada de sincronización del equipo Cloud IX), holtskinner (6), martinvarelaj (3), helloeve (1), jsondai (1) y wangauone (1).

Caveats: la API de GitHub usa open_issues_count, que puede incluir solicitudes de cambios abiertas, por lo que el 35 no debe leerse como un conteo exclusivo de incidencias. El campo watchers_count de la respuesta general replica las estrellas; no se reporta un número de suscriptores por separado. El conteo de 277 commits se obtuvo del encabezado Link de paginación de la API de commits (rel="last" en la página 3). El lenguaje principal figura como Python, aunque gran parte del contenido son archivos Markdown de instrucciones.

Cómo contribuir

El proceso está documentado en CONTRIBUTING.md y es notoriamente cerrado:

No se aceptan solicitudes de cambios (PR) externas ni contribuciones de código. Todas las skills deben superar un riguroso proceso interno de verificación y aprobación de los equipos de Google para garantizar exactitud técnica, seguridad y alineación arquitectónica.
Lo que sí se puede hacer:
- Informar problemas: abrir un issue si se encuentra un bug, un patrón de SDK obsoleto o un anti-patrón de seguridad en una skill.
- Solicitar nuevas skills: proponer productos de Google o patrones arquitectónicos cruzados a cubrir, vía issue tracker.
- Remix y compartir: se anima a hacer fork del repositorio y remezclar las skills para flujos especializados propios.
Equipos internos de Google: los miembros de equipos de Google que autoren o actualicen una skill para su producto deben consultar la documentación interna del Agent Skills Program para las pautas de autoría y la especificación SKILL.md.

Esta limitación explica el diseño de calidad del repositorio: en vez de una comunidad de contribuidores abierta, hay propietarios de skill y un pipeline de evaluación interno.

Cómo lo recibió la comunidad

La evidencia recuperada muestra una adopción destacada por su origen oficial, pero también una crítica concreta sobre el tono de las instrucciones:

El propio equipo de Google afirma, en el artículo «Behind the scenes», que la recepción inicial de la comunidad superó las expectativas con más de 15.000 estrellas de GitHub. Esa cifra es una afirmación del equipo, no una medición independiente.
En el hilo de Hacker News 47891283, el usuario v-mdev presentó el artículo de lanzamiento («Google Unveils Agent Skills Repository for Smarter AI Agents»); el envío alcanzó 5 puntos con 1 comentario (el propio enlace al repositorio).
En el hilo de Hacker News 48463481, el usuario ulrischa presentó directamente el repositorio (1 punto, 1 comentario). El comentario de verdverm es la crítica más concreta encontrada: «Algunas de esas instrucciones parecen estar ahí porque gemini es tan malo siguiendo instrucciones. Los modelos gemini son básicamente inutilizables para programación ahora mismo, parecen haber retrocedido en capacidad». Es una objeción a la necesidad de instrucciones tan detalladas, atribuida a ese usuario.
El anuncio de Agent Skills en Google Antigravity generó el hilo de Hacker News 46613546 (2 puntos, 0 comentarios) y el artículo de blog.google «Improve Coding Agents’ Performance with Gemini API Docs MCP and Agent Skills» el hilo 47596867 (2 puntos, 0 comentarios).

En conjunto, la recepción refleja el perfil típico de un recurso oficial de proveedor: adopción impulsada por la autoridad de Google, con poca discusión crítica extensa en Hacker News durante las consultas realizadas. No se encontraron hilos amplios de Reddit verificables en esta ejecución (el endpoint JSON de Reddit devolvió una página anti-bot), por lo que no se infieren reacciones comunitarias que las fuentes no muestran.

google/skills frente a otras propuestas

Proyecto	Coincidencia verificable	Diferencia verificable
`obra/superpowers`	Biblioteca de habilidades/instrucciones para agentes de código que impone un proceso.	Superpowers es una iniciativa de un autor individual con foco en metodología de desarrollo (TDD, planificación, revisión); `google/skills` es oficial de Google y enfocado a conocimiento de dominio de productos de Google.
`anthropics/skills` (y `huggingface/skills`, `MiniMax-AI/skills`, `slavingia/skills`)	Repositorios de «Agent Skills» del mismo formato abierto (SKILL.md + instrucciones) para agentes de código.	Cada uno empaqueta el conocimiento del propio proveedor (Anthropic, Hugging Face, MiniMax); `google/skills` cubre exclusivamente tecnologías de Google y está validado internamente.
Especificación `agentskills.io`	Define el formato abierto (carpeta + `SKILL.md` con `name`/`description`) que usan todos los repos de skills.	Es la especificación/formato, no un repositorio de skills; `google/skills` es una implementación de esa especificación.

La comparación más útil no es por popularidad: google/skills destaca cuando se necesita conocimiento de dominio de productos de Google respaldado por el propio proveedor. Cuando se busca una metodología transversal de desarrollo o el conocimiento de otro proveedor, repos como obra/superpowers o los skills de Anthropic/Hugging Face son los equivalentes de su respectivo ecosistema.

Casos de uso

Equipos de ingeniería que construyen sobre Google Cloud (GKE, BigQuery, Cloud SQL, Spanner, AlloyDB, Cloud Run, Firebase) pueden cargar las skills correspondientes para que sus agentes de código propongan comandos gcloud, manifiestos y arquitecturas validadas y acordes a las mejores prácticas de Google, en vez de depender del conocimiento (a veces desactualizado) del modelo.
Consultores, SREs y arquitectos de soluciones que diseñan soluciones multi-producto (los «solution skills» como solution-architecture, borderless data lakehouse o n-tier serverless web app) pueden usar el repositorio como base de instrucciones para que el agente aplique el marco Well-Architected (seguridad, fiabilidad, costes, rendimiento, sostenibilidad) al proponer arquitecturas.
Datos e ingenieros de datos (BigQuery, BigFrames, Spanner, AlloyDB, Managed Airflow, Data Lineage) pueden aprovechar skills específicas y el plugin data-agent-kit para escribir consultas, transformar con dbt y orquestar pipelines desde el agente.
Desarrolladores de Ads y Analytics (Google Ads API, Data Manager, IMA, Mobile Ads SDK, Analytics Admin/Data API) tienen skills dedicadas para integraciones, ingesta de audiencias/eventos y migración a la generación siguiente.
Personas que ya usan agentes de código (Claude Code, Codex, Antigravity) y quieren reforzar la precisión en el stack de Google sin construir sus propias instrucciones pueden simplemente instalar las skills y, si lo necesitan, hacer fork para adaptarlas a flujos internos.

Recursos

Repositorio: https://github.com/google/skills
Documentación / especificación del formato: https://agentskills.io/home · https://agentskills.io/specification
Skills / plugins oficiales: https://github.com/google/skills/tree/main/skills · marketplace google-plugins en .claude-plugin/marketplace.json
Instalación: https://skills.sh/google/skills (npx skills add google/skills)
Blog de lanzamiento: https://cloud.google.com/blog/topics/developers-practitioners/level-up-your-agents-announcing-googles-official-skills-repository (22 de abril de 2026)
Blog «Behind the scenes»: https://cloud.google.com/blog/topics/developers-practitioners/behind-the-scenes-how-we-build-test-and-scale-google-agent-skills
Docs de Agent Skills en Antigravity: https://antigravity.google/docs/skills
Blog (Gemini API Docs MCP + Agent Skills): https://blog.google/innovation-and-ai/technology/developers-tools/gemini-api-docsmcp-agent-skills/
Hilos de HN relevantes: 47891283, 48463481, 46613546, 47596867
Repositorios compañeros (skills oficiales de Google): google/agents-cli, android/skills, dart-lang/skills, firebase/agent-skills, flutter/agent-plugins, genkit-ai/skills, googlemaps/agent-skills, gemini-cli-extensions/google-cloud-storage

Este artículo combina el README, el CONTRIBUTING.md, el marketplace.json y los .gitmodules del repositorio, los artículos oficiales de Google Cloud, la especificación de agentskills.io y la API de GitHub, consultados el 25 de agosto de 2026. Las cifras de estrellas y forks de los repositorios compañeros y del propio repo cambian con el tiempo.