gcp-playbooks — Claude Code skill: what it does, how to install
gcp-playbooks is a Claude Code skill with SRE playbooks for investigating GCP incidents and running mitigations across GKE and Cloud Run.
Apache-2.0 ★ 151 updated 2026-10-12
/plugin marketplace add gemini-cli-extensions/sre
/plugin install sre-extension@sreWhat gcp-playbooks does
This skill connects generic SRE procedures with concrete GCP and GKE remediation commands. It stores reference guides named after GCP API identifiers inside references/googleapis.com/, covering Cloud Run (run.md), Kubernetes Engine (container.md), and Cloud Build (cloudbuild.md).
The diagnostic flow starts by mapping the blast radius using gcp_resource_manager or the discovery guide. After identifying the affected service, the agent selects the matching guide and runs targeted gcloud or kubectl steps while validating changes at each stage. Without configured GCP credentials and installed CLI tools, the agent cannot execute these playbook actions.
What it helps with
- discover infrastructure resources involved in a GCP incident
- execute rollbacks or traffic shifts on Cloud Run services
- quarantine, resize, or restart workloads in GKE clusters
- troubleshoot failing pipelines using Cloud Build checklists
Example prompts for the agent
- Run the GCP discovery playbook to locate the resources tied to this incident
- Follow the run.googleapis.com playbook to roll back our Cloud Run deployment
- Check container.md mitigation steps to quarantine this failing GKE pod
How to install gcp-playbooks
1Plugin marketplace
/plugin marketplace add gemini-cli-extensions/sre/plugin install sre-extension@sreThis installs the whole sre-extension plugin with all its skills
2Skills CLI (Vercel)
npx skills add gemini-cli-extensions/sre --skill gcp-playbooks -a claude-code3Manually: put the files in place
~/.claude/skills/gcp-playbooks/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/gcp-playbooks/
1Skills CLI (Vercel)
npx skills add gemini-cli-extensions/sre --skill gcp-playbooks -a codex2Manually: put the files in place
.agents/skills/gcp-playbooks/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add gemini-cli-extensions/sre --skill gcp-playbooks -a cursor2Manually: put the files in place
.cursor/skills/gcp-playbooks/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install gemini-cli-extensions/sre skills/gcp-playbooks2Manually: put the files in place
.github/skills/gcp-playbooks/SKILL.md1Skills CLI (Vercel)
npx skills add gemini-cli-extensions/sre --skill gcp-playbooks -a gemini-cli2Platform CLI
gemini skills install https://github.com/gemini-cli-extensions/sre --path skills/gcp-playbooksManually: put the files in place
.devin/skills/gcp-playbooks/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about gcp-playbooks
How to install gcp-playbooks in Claude Code?
Run npx skills add gemini-cli-extensions/sre --skill gcp-playbooks -a claude-code in your terminal, or register the repository with /plugin marketplace add gemini-cli-extensions/sre and run /plugin install sre-extension@sre.
What does the gcp-playbooks skill do?
It gives coding agents standard mitigation checklists mapping actions like restart, upsize, quarantine, and rollback directly to gcloud and kubectl invocations.
Which GCP services have reference guides in this skill?
The repository includes playbooks for Cloud Run (run.googleapis.com), GKE (container.googleapis.com), and a draft guide for Cloud Build (cloudbuild.googleapis.com).
Source text
SKILL.md · Apache-2.0
--- name: gcp-playbooks description: 🐉 Use when you need to follow established SRE playbooks for GCP/GKE investigations, including infrastructure discovery and common mitigation steps. metadata: author: Riccardo version: 0.0.3 status: draft --- # GCP SRE Playbooks ## Overview This skill provides a collection of playbooks and reference materials for SREs to investigate and mitigate incidents on Google Cloud Platform. It focuses on mapping generic SRE concepts (discovery, mitigation, postmortem) to specific GCP/GKE actions. ## Naming Convention Playbooks follow a deterministic naming convention based on the GCP API service name, located in the `references/googleapis.com/` directory. Example: `run.md` (for `run.googleapis.com`). Each file should also explicitly list the full API name at the top. ## When to Use - When starting an investigation and needing to discover the infrastructure. - When following a specific mitigation strategy (e.g., rollback, traffic shifting). - When a user asks for "GCP playbooks" or "SRE playbooks". ## Available Playbooks ### 1. Infrastructure Discovery Located at `skills/gcp-playbooks/references/googleapis.com/README.md`. Use this to systematically identify the resources involved in an incident. ### 2. Cloud Run Mitigations Located at `skills/gcp-playbooks/references/googleapis.com/run.md`. Maps generic mitigations (rollback, fix forward, upsize, restart) to Cloud Run actions. ### 3. GKE Mitigations Located at `skills/gcp-playbooks/references/googleapis.com/container.md`. Maps generic mitigations (rollback, fix forward, upsize, quarantine, restart) to GKE / Kubernetes actions. ### 4. Cloud Build Investigation (Draft) Located at `skills/gcp-playbooks/references/googleapis.com/cloudbuild.md`. ## Core Pattern 1. **Identify the Scope**: Use `gcp_resource_manager` or the discovery playbook to find the relevant project and resources. 2. **Consult the Playbook**: Look for a matching playbook in `references/googleapis.com/` using the short API name. 3. **Execute Actions**: Follow the gcloud/kubectl commands suggested in the playbook. 4. **Validate**: Verify the state of the system after each action. ## References - [GCP Documentation](https://cloud.google.com/docs)
© Riccardo · Apache-2.0 · gemini-cli-extensions/sre