skills/gcloud-cli/SKILL.md
Execute Google Cloud Platform operations using the gcloud CLI (and gsutil/bq where applicable). Use when the user wants to: authenticate with GCP, manage GCP resources, deploy applications, configure projects or IAM, view logs, run SQL/BigQuery, or interact with any GCP service from the command line. Triggers on phrases like "gcloud", "Google Cloud CLI", "deploy to GCP", "create a VM", "Cloud Run", "GKE cluster", "Cloud Storage bucket", "set GCP project", "service account", "Cloud Functions", "App Engine deploy", or any request to manage Google Cloud resources via command line.
npx skillsauth add arisng/github-copilot-fc gcloud-cliInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
gcloud [GROUP] [SUB-GROUP] COMMAND [FLAGS]
Examples:
gcloud compute instances list
gcloud run services deploy my-svc --image gcr.io/my-project/my-image
gcloud projects list
# One-time setup
gcloud init
# Set active project
gcloud config set project PROJECT_ID
# Set default region/zone
gcloud config set compute/region us-central1
gcloud config set compute/zone us-central1-a
# View current config
gcloud config list
# Named configurations (switch between projects/envs)
gcloud config configurations create staging
gcloud config configurations activate staging
# Interactive login (local dev)
gcloud auth login
# Application Default Credentials (SDK/code usage)
gcloud auth application-default login
# Service account key
gcloud auth activate-service-account SA_EMAIL --key-file=key.json
# Impersonate a service account
gcloud [COMMAND] --impersonate-service-account=SA_EMAIL
# Check who you're authenticated as
gcloud auth list
--format=json # Machine-readable
--format=yaml # Human-readable structured
--format=table(col1,col2) # Custom table columns
--format="value(name)" # Single field extraction
# Filtering
--filter="status=RUNNING"
--filter="name ~ '^prod-'" # regex match
--sort-by=createTime
--limit=10
| Flag | Purpose |
|------|---------|
| --project=PROJECT_ID | Override active project |
| --region=REGION | Override default region |
| --zone=ZONE | Override default zone |
| --quiet / -q | Skip confirmation prompts |
| --verbosity=debug | Debug output |
| --dry-run | Preview without executing (where supported) |
For service-specific commands (Compute Engine, Cloud Run, GKE, Cloud Storage, IAM, App Engine, Cloud Functions, Cloud SQL, BigQuery, Pub/Sub, Artifact Registry), see references/services.md.
gcloud RESOURCE describe RESOURCE_NAME [--region/--zone]
# Most commands support --async; poll with:
gcloud compute operations wait OPERATION_ID
--format=value() in scriptsPROJECT=$(gcloud config get-value project)
IMAGE_DIGEST=$(gcloud container images describe gcr.io/$PROJECT/app:latest --format="value(image_summary.digest)")
gcloud RESOURCE add-iam-policy-binding RESOURCE_ID \
--member="serviceAccount:[email protected]" \
--role="roles/ROLE"
devops
Programmatically create tldraw whiteboards and visualize them with a self-hosted tldraw instance. Create boards with shapes, text, and connectors, then deploy to a self-hosted server for collaborative editing and gallery management.
testing
Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.
development
Session-scoped git commit orchestrator that commits only current-session changes and leaves unrelated dirty worktree edits untouched. Inherits git-atomic-commit for atomic grouping and commit message execution, and git-commit-scope-constitution for scope governance and validation. Use when asked to commit this session only or isolate commits from mixed worktree state.
documentation
Compact the current conversation into a handoff document for another agent to pick up.