Railway's official agent skill: create projects, provision databases and buckets, deploy, manage variables and domains, and read build failures back — from the CLI, API or MCP server.
gcloud CLI Guardrails Skill
Google's official skill for driving the gcloud CLI safely from an agent: validate every command against its own help text, cap the output, and refuse the operations that should never run unattended.
Install
Other ways to install
About
- Mandatory `gcloud help <leaf command>` validation before any command is proposed or run
- Blocks `list` commands that lack --limit, --filter or --format, with a schema-discovery workflow
- Denylist for IAM, delete, billing, organizations, KMS and infra-manager apply operations
- Requires --dry-run or --validate-only first wherever the command supports it
- Forces --quiet and explicit --project plus location flags for headless, non-interactive runs
- Bans pipes, redirection, command substitution and chaining so every step stays reviewable
- Recommends --async with operation polling for long-running operations
The gcloud CLI has thousands of leaf commands and its flags drift between releases, which makes it precisely the kind of surface a language model will confidently get wrong. Google's official skill starts from that premise and builds three defences on top of it.
1. Never trust remembered syntax
The skill's opening instruction is blunt: all pre-existing knowledge of gcloud commands, flags and positional arguments is stale and prone to hallucination. Before proposing or running anything, the agent must call gcloud help <leaf command> for the exact command — validation is explicitly not transitive from parent groups, so gcloud help compute does not license a guess at gcloud compute instances create. Even a plan has to include the help lookup as a step.
2. Never blow up the context window
gcloud ... list on a real project can return megabytes of JSON. The skill forbids any list without at least one of --limit, --filter or --format, and teaches the schema-discovery move that makes projection possible: run the list once with --limit=1 --format=json, read the key paths, then request only those fields. It also pins down filter syntax — prefer : for pattern matching, never quote the right-hand side, treat the whole flag as one string.
3. Never surprise the human
A denylist covers what an agent must not do on its own: IAM policy, role or binding changes, any gcloud * delete, gcloud billing *, gcloud organizations *, gcloud kms *, and gcloud infra-manager deployments apply. Enabling APIs is also off-limits unprompted, since it provisions resources and starts billing. Where a command offers --dry-run or --validate-only, using it first is mandatory.
Headless execution
Two rules exist purely because agents have no TTY. Every command carries --quiet so a confirmation prompt cannot hang the run forever, and every command carries an explicit --project plus region/zone/location flags so gcloud never stops to ask which one you meant — with discovery commands listed for finding those values first. Shell operators are banned outright: no pipes, no redirection, no $(...) substitution, one command at a time, so a human reviewing the transcript can read exactly what ran.
Scope
Use it for anything gcloud; do not use it for Google Cloud client-library code or raw REST/gRPC calls. Part of Google's official agent-skills catalogue at github.com/google/skills, Apache-2.0.
Try it
Once installed, ask your agent something like:
List the Cloud Run services in my staging project that have more than one revision, and show only name and region.
SKILL.md
The instructions your agent loads, as published by Google Cloud.
Covered in the Weekly
- Onei AI Weekly #4 — August 24, 2026
Related Skills
See all gcloud CLI Guardrails alternativesSkill: PlanetScale Change Gates
by PlanetScale
PlanetScale's approval contract for agents: five operation classes that decide what a database agent may do freely, what needs a named approval, and what it must never do alone.
Google's official Well-Architected Framework skill for the security pillar — turns an architecture review into a structured interview, gap analysis and prioritised recommendations.
Skill: AlloyDB Basics
by Google
Google's official AlloyDB for PostgreSQL skill — cluster and instance lifecycle from gcloud, plus hard rules on private connectivity, IAM database auth and backup behaviour.