Skill del día: google-agents-cli-deploy, tu agente despliega agentes en Google Cloud con tu permiso

Unas 1.800 instalaciones en 24 horas colocan a google-agents-cli-deploy en la lista Trending de skills.sh, con 533.100 instalaciones acumuladas desde que apareció el 21 de abril de 2026. Es la skill de despliegue de agents-cli, la CLI de Google para crear, evaluar y desplegar agentes en Google Cloud, y su versión 1.12.0, del 27 de octubre de 2026, declara ADK Go como disponible para producción y estrena una extensión experimental para agentes hechos con el Claude Agent SDK.

01Qué hace

Se activa cuando le pides al agente cosas como "despliega mi agente ADK", "configura el CI/CD", "configura los secretos" o "soluciona un despliegue", y sirve para cualquier framework que agents-cli sepa desplegar (ADK, LangChain…). No escribe el código del agente ni lo evalúa: para eso hay otras skills de la misma suite.

Lo más útil es que le da al agente criterio, no solo comandos:

• Elegir destino. Una matriz compara Agent Runtime (el servicio gestionado de Google para agentes), Cloud Run y GKE en escalado, red, estado de sesión, modelo de coste y complejidad, y le ordena preguntarte cuál quieres en lugar de decidir por ti.
• Desplegar con permiso. El flujo a dev es: enseñarte los resultados de evaluación y tests, preguntar si se despliega y esperar una aprobación explícita antes de lanzar agents-cli deploy. La skill lo repite en mayúsculas: nunca desplegar sin aprobación humana.
• Dimensionar. Explica los valores por defecto (--cpu 1, --memory 4Gi, --concurrency 8, de 0 a 10 instancias) y por qué la memoria, no la CPU, es el primer límite: cada petición concurrente retiene su contexto mientras espera al modelo, así que subir la concurrencia sin subir la memoria es la causa típica de OOM.
• Secretos, IAM y rollback. Secret Manager en vez de variables de entorno, qué cuenta de servicio necesita secretAccessor en cada destino, una tabla de errores 403 habituales con su causa, y cómo volver atrás: tráfico entre revisiones en Cloud Run, kubectl rollout undo en GKE y redeploy en Agent Runtime, que no tiene rollback por revisiones.

02Cómo instalarla y usarla

La skill necesita la CLI. Las dos piezas, según el README y la propia skill:

uv tool install google-agents-cli
npx skills add https://github.com/google/agents-cli --skill google-agents-cli-deploy

uvx google-agents-cli setup instala la CLI y las siete skills de la suite en tus agentes de código (Claude Code, Codex, Antigravity CLI…). Después basta con pedirlo en lenguaje natural. Si quieres ver lo que haría sin tocar nada, la skill recomienda agents-cli deploy --dry-run, que en la 1.12.0 también valida contra Google Cloud un despliegue en Cloud Run e imprime el comando gcloud completo, y --no-wait con --status para despliegues en Agent Runtime, que tardan de 5 a 10 minutos.

03Riesgos y límites

• Tus credenciales, tu proyecto. La skill no declara allowed-tools: tu agente ejecuta agents-cli, gcloud, Terraform y kubectl con la identidad que tengas activa y crea recursos que pagas tú. Ejecútalo con una cuenta limitada al proyecto de dev.
• Permisos amplios en CI/CD. Para montar el pipeline pide conceder roles/secretmanager.admin a la cuenta de servicio de Cloud Build. Es lo que necesita para leer el token de GitHub, pero es un rol de administración: revísalo antes de aplicarlo.
• Comandos delicados en la tabla de problemas. Incluye terraform force-unlock -force para un estado bloqueado. Si el bloqueo es de otro pipeline en marcha, forzarlo corrompe el estado; no dejes que el agente lo ejecute sin preguntarte.
• Telemetría. Cada comando de agents-cli escribe una entrada en el Cloud Logging de tu propio proyecto y envía a Google la versión, el sistema operativo y el nombre del comando en las cabeceras. Se desactiva con AGENTS_CLI_TELEMETRY=0 o DO_NOT_TRACK=1.
• Dependencia de PyPI. La CLI llega como paquete google-agents-cli; fija la versión en CI para no recibir cambios sin revisar. La 1.11.0, del 20 de octubre, ya trajo un cambio incompatible.

La página de skills.sh marca la skill como aprobada en las auditorías de Gen Agent Trust Hub, Socket y Snyk, y el repositorio, con 6.278 estrellas, tiene licencia Apache 2.0.

04Frente a hacerlo a mano con gcloud

Sin la skill, el agente tiraría de lo que sabe de gcloud run deploy, Terraform y la consola, y tú tendrías que corregirle las cuentas de servicio y las banderas. Con ella, el agente usa una CLI que envuelve Terraform, Docker y el despliegue en un flujo probado, y la tabla de 403 le ahorra la típica ronda de "permiso denegado". La salida de emergencia sigue ahí: --dry-run imprime el gcloud equivalente para copiarlo y añadir lo que la CLI no expone.

Merece la pena si despliegas agentes ADK o LangChain en Google Cloud y quieres que tu agente de código siga las prácticas de Google, sobre todo para Agent Runtime, que no tiene comando de gcloud. Si tu agente es un servicio más en Cloud Run con tu propio Terraform, aporta menos: la parte que vale es la de dimensionado y diagnóstico de IAM, y eso cabe en tu CLAUDE.md.

05Fuentes

• google-agents-cli-deploy — skills.sh
• agents-cli: the CLI and skills for building agents on Gemini platform — Google (GitHub)
• google-agents-cli-deploy SKILL.md (v1.12.0) — Google (GitHub)
• agents-cli release notes (1.12.0) — Google (GitHub)
• Trending skills (24 h) — skills.sh