gcp-troubleshoot

Community

Quickly resolve GCP service issues, tool-first.

Authortimbuchinger
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill streamlines troubleshooting across various GCP services by guiding you through a systematic, tool-first diagnostic process. It helps you quickly identify root causes for issues in Firestore, Cloud Run, IAM, and other key services.

Core Features & Use Cases

  • Service-Specific Diagnostics: Provides targeted troubleshooting for Firestore, Cloud Run, networking, IAM, Pub/Sub, Cloud SQL, and Storage.
  • Tool-First Approach: Prioritizes using efficient tool-based access (e.g., MCP) for logs, metrics, and audit events, falling back to gcloud CLI only when necessary.
  • Systematic Workflow: Guides through identifying the resource, querying scoped logs/metrics/audit logs, interpreting patterns, and suggesting actionable fixes.
  • Use Case: Your Cloud Run service is failing to start. This Skill helps you query Cloud Run logs, check revision history, and look for Cloud SQL connector errors to diagnose the problem efficiently.

Quick Start

Troubleshoot a 'PERMISSION_DENIED' error I'm getting when accessing Firestore, checking audit logs for the principal and role mismatch.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: gcp-troubleshoot
Download link: https://github.com/timbuchinger/loadout/archive/main.zip#gcp-troubleshoot

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.