Skip to main content
skill CX Codex

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

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add gemini-cli-extensions/sre
/plugin install sre-extension@sre
Open on GitHub

What 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@sre

This 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-code

3Manually: put the files in place

~/.claude/skills/gcp-playbooks/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/gcp-playbooks/

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

Similar skills

All skills for Cloud: AWS, Azure, GCP →

From the same set17

The whole set →
gcp-setup The gcp-setup skill checks and aligns identities across gcloud, Application Default Credentials, and kubectl at the start of your session. Use it to ensure all three systems authenticate as the same user before you begin working with GCP. CX Codex +1 ★ 151repo stars data-ingestion data-ingestion collects time-series points from CSV files or metric backends and converts them into standardized JSON. CX Codex +1 ★ 151repo stars cloud-logging Skill for analyzing Google Cloud Logging and Error Reporting. Processes large JSON logs from GCP and converts them to Apache format for efficient analysis. CX Codex +1 ★ 151repo stars gcp-slo-management gcp-slo-management finds services in Google Cloud Monitoring and creates availability or latency SLOs over the REST API, where gcloud has no command for it. CX Codex +1 ★ 151repo stars pre-publish-checker pre-publish-checker audits project files for profanity, internal links, sensitive paths, and unfinished development markers. Use it when preparing code or an extension for public release. CX Codex +1 ★ 151repo stars safe-sre-investigator safe-sre-investigator creates dedicated read-only service accounts for GCP and Kubernetes, then hands you gcloud and kubectl commands with a risk rating attached. CX Codex +1 ★ 151repo stars cloud-monitoring Interacts with Google Cloud Monitoring through MCP, rendering ASCII sparklines and concise CSV summaries to prevent context bloat. CX Codex +1 ★ 151repo stars postmortem-aggregator postmortem-aggregator turns Post Mortem files in a folder into incident statistics and updates POMO_AGGREGATED.md. Use it to spot recurring causes across incidents. CX Codex +1 ★ 151repo stars

Project sponsors

Companies that keep this analytics open