agentleFS
marcfargasmarcfargas/skills/gcloud/SKILL.md

gcloud

Skill4 starsChanged 9 months agoMITView on GitHub

Google Cloud Platform CLI (gcloud, gcloud storage, bq). Use when: managing GCP resources, deploying to Cloud Run/Cloud Functions/GKE/App Engine, working with Cloud Storage, BigQuery, IAM, Compute Engine, Cloud SQL, Pub/Sub, Secret Manager, Artifact Registry, Cloud Build, Cloud Scheduler, Cloud Tasks, Vertex AI, VPC/networking, DNS, logging/monitoring, or any GCP service. Also covers: authentication, project/config management, CI/CD integration, serverless deployments, container registry, docker push to GCP, managing secrets, Workload Identity Federation, and infrastructure automation.

13 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use aws.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • VercelSkill

    aws

    Emulated AWS cloud services (S3, SQS, Cognito, IAM, STS) for local development and testing. Use when the user needs to interact with AWS API endpoints locally, test S3 bucket and object operations, emulate SQS queues and messages, test Cognito sign-up, sign-in, JWTs, or Identity Pools, manage IAM users/roles/access keys, test STS assume role, or work without hitting real AWS APIs. Triggers include "AWS emulator", "emulate AWS", "mock S3", "local SQS", "test IAM", "emulate S3", "AWS locally", "STS assume role", or any task requiring local AWS service emulation.

    Also in 4 projects that use this

The file

We split this skill into the rules it gives an agent

2 rules. 0 are common, 1 is distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 12 edited versions we read keep these.

  • 1

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    If installed via scoop, gcloud components install may not work — use scoop to manage

    line 22
  2. Distinctive:

    Before working with any GCP service:

    line 86

“Common” is measured: kept by at least 6 in 10 of the 12 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

gcloud — Google Cloud Platform CLI

Command-line interface for managing Google Cloud resources. Covers gcloud, gcloud storage (replaces gsutil), and bq (BigQuery).

Platform Notes (Windows + Git Bash)

  • Install: scoop install gcloud (preferred) or GoogleCloudSDKInstaller.exe
  • If installed via scoop, gcloud components install may not work — use scoop to manage
  • Config: %APPDATA%/gcloud/ (PowerShell) or ~/.config/gcloud/ (Git Bash)
  • Service account keys: store in $TEMP or project .secrets/, never commit
  • Python: gcloud requires Python; scoop install handles this automatically

⚠️ Path Translation Gotcha

Git Bash auto-translates /-prefixed args, breaking some gcloud commands:

# FIX — disable MSYS path conversion:
export MSYS_NO_PATHCONV=1

# Or per-command:
MSYS_NO_PATHCONV=1 gcloud projects add-iam-policy-binding my-project ...

⚠️ Cost: Commands that create resources (instances, clusters, databases) incur GCP charges. Always confirm project and region before creating.

Agent Safety Model

Operations classified by risk. Follow this model for all gcloud commands.

LevelGateExamples
READProceed autonomouslylist, describe, get, logs read, config list, gcloud storage ls
WRITEConfirm with user; note cost if billablecreate, deploy, update, enable, gcloud storage cp (upload)
DESTRUCTIVEAlways confirm; show what's affecteddelete, rm, gsutil rm -r, bq rm -r, rsync -d, IAM removal
EXPENSIVEConfirm + state approximate costGKE clusters ($70+/mo), SQL instances ($8-400/mo), VMs (~$5-2k/mo)
SECURITYConfirm + explain impact--allow-unauthenticated, firewall rules, IAM owner/editor grants
FORBIDDENRefuse; escalate to humangcloud iam service-accounts keys create, gcloud projects delete, passwords in CLI args

Rules:

  • Never combine --quiet with destructive operations — it suppresses the only safety gate
  • Never put passwords/secrets as command-line arguments — visible in process list & shell history
  • Always use --format=json for machine-parseable output (agents can't reliably parse tables)
  • When in doubt, treat as DESTRUCTIVE

Command Structure

gcloud [RELEASE_LEVEL] COMPONENT ENTITY OPERATION [ARGS] [FLAGS]

Key global flags: --project, --format, --filter, --limit, --quiet, --verbosity, --async

Service Reference

ServiceFileKey Commands
Auth & Configauth.mdLogin, ADC, impersonation, config profiles
IAM & Projectsiam.mdProjects, APIs, service accounts, Secret Manager
Compute & Networkingcompute.mdVMs, SSH, firewall, VPC, DNS, static IPs
Serverlessserverless.mdCloud Run, Functions, App Engine, Scheduler, Tasks
Storage & Artifactsstorage.mdgcloud storage, Artifact Registry
Datadata.mdCloud SQL, BigQuery (bq), Pub/Sub
Automation & CI/CDautomation.mdScripting, output formats, filtering, GitHub Actions, operations

Read the per-service file for full command reference.

Pre-Flight Checks

Before working with any GCP service:

# 1. Correct project?
gcloud config get-value project

# 2. Default region set?
gcloud config get-value compute/region

# 3. Required API enabled? (most APIs are disabled by default)
gcloud services list --filter="name:run.googleapis.com" --format="value(name)" | grep -q run || \
  gcloud services enable run.googleapis.com

# 4. Billing enabled?
gcloud billing projects describe $(gcloud config get-value project) --format="value(billingEnabled)"

If you hit PERMISSION_DENIED: ... API has not been enabled, enable the API mentioned in the error and retry.

Troubleshooting

ProblemDiagnosisFix
Auth failuregcloud auth listgcloud auth login or check key file
Permission deniedCheck IAM (see iam.md)Grant correct role
API not enabledError message says which APIgcloud services enable API_NAME
Quota exceededgcloud compute project-info describeRequest increase in Console
Wrong projectgcloud config get-value projectgcloud config set project X
Wrong regiongcloud config get-value compute/regionSet correct region; related resources must match
Config confusiongcloud config configurations listCheck active config, override with --project
Slow commandsLarge result setUse --filter, --limit, --format=value
# Debug mode
gcloud compute instances list --verbosity=debug

# Full environment info
gcloud info

Quick Reference

TaskCommand
Logingcloud auth login
Set projectgcloud config set project PROJECT_ID
Current projectgcloud config get-value project
Enable APIgcloud services enable API.googleapis.com
List anythinggcloud COMPONENT list --format=json
Describe anythinggcloud COMPONENT describe NAME --format=json
JSON output--format=json
Single value--format="value(field)"
Filter--filter="field=value"
Quiet ⚠️--quiet — suppresses ALL prompts including delete confirmations
Helpgcloud COMPONENT --help

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.