New to Claude Skills? Learn how to install them →

Get Claude Skills
google on GitHub

Infrastructure Deployment Debugging

Free

Resolve deployment failures for ADC and Terraform.

by google17.6k stars on google/skills
2 views
Updated Aug 10, 2026
Get this skill

Free · Opens the source repo

What Infrastructure Deployment Debugging does

The Infrastructure Deployment Debugging skill is designed to assist developers and engineers in troubleshooting deployment failures specifically related to Application Design Center (ADC) applications and raw Terraform configurations. It provides a structured approach to diagnosing issues, ensuring that users adhere to a strict sequence of troubleshooting steps. This skill is particularly useful for those who are managing cloud infrastructure and need to resolve deployment errors without executing any potentially harmful commands.

When using this skill, users will follow a defined process that begins with determining the context of the deployment failure. The skill distinguishes between ADC application deployments and raw Terraform deployments based on the user's input. For ADC applications, it directs users to a comprehensive troubleshooting template that guides them through the necessary steps to identify and resolve issues. Similarly, for raw Terraform deployments, users are directed to specific instructions tailored to Terraform's unique configuration and error messages.

One of the key features of this skill is its emphasis on a read-only discovery process. Users are instructed to utilize standard commands and avoid any mutating deployment commands, ensuring that the troubleshooting process does not inadvertently alter the state of the infrastructure. This approach minimizes the risk of further complications during the debugging process, allowing users to focus on diagnosing and resolving issues effectively.

Overall, this skill is an essential tool for developers and DevOps professionals who need a reliable method for troubleshooting deployment failures in cloud environments. It streamlines the debugging process, providing clear guidance and ensuring adherence to best practices in infrastructure management.

When to use it

Use this skill when you encounter deployment errors in ADC applications or Terraform configurations and need a structured troubleshooting approach.

When not to use it

This skill is not suitable for design tasks, local validation, or any non-deployment related troubleshooting.

What you can build with it

Troubleshooting an ADC Application

When a developer encounters an error during the deployment of an ADC application, they can use this skill to follow a structured troubleshooting template.

Resolving Terraform Configuration Errors

If a DevOps engineer receives an error message while applying a Terraform configuration, they can utilize the skill to analyze the raw Terraform code and identify issues.

Ensuring Safe Debugging Practices

During the debugging process, users can rely on this skill to ensure that no commands are executed that could alter the infrastructure state.

How to install Infrastructure Deployment Debugging

View source

1. Install with the skills CLI

npx skills add google/skills/infra-deployment-debugging --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by google

Deployment Troubleshooting Skill

Use this skill to analyze and resolve deployment failures. This skill supports troubleshooting:

  1. ADC Applications: High-level designs deployed in Application Design Center.
  2. Raw Terraform (TF): Infrastructure configurations managed directly via Terraform HCL files.

Constraints

  • Use standard tools: All interactions with GCP must be performed using standard commands (e.g., gcloud, terraform). Do not use custom internal backend APIs.
  • No Real Deployments: NEVER run mutating deployment commands (e.g., gcloud design-center spaces applications deploy or terraform apply) under any circumstances, as this is a read-only validation and dry-run troubleshooting workflow.
  • Read-Only Discovery: Do not run mutating commands during discovery. Discovery must be strictly read-only.
  • Strict Step Adherence: You MUST execute all steps in the chosen troubleshooting template in sequence. Do NOT skip steps or jump directly to remediation, even if the error seems obvious. Every step (e.g., init, validate, plan, or describes/logs fetches) must be executed and their outputs verified.

Troubleshooting Process (Progressive Disclosure)

To begin, you must determine the appropriate troubleshooting context based on the user's input.

Step 1: Determine the Entry Point

Evaluate the input provided by the user:

  • Case A: ADC Application Deployment:
    • Indicator: The input contains an application_uri (e.g., projects/P/locations/L/spaces/S/applications/A) or references an App Design Center context.
    • Act: Read and follow the detailed instructions in adc_application_troubleshooting.md to complete the troubleshooting task.
  • Case B: Raw Terraform Deployment:
    • Indicator: The input contains raw Terraform configuration code (HCL contents), .tf files, or direct Terraform plan/apply execution errors.
    • Act: Read and follow the detailed instructions in raw_terraform_troubleshooting.md to complete the troubleshooting task.

Reporting Issues

Report bugs or improvements for this skill at Google Skills Issues.

Frequently asked questions about Infrastructure Deployment Debugging

Similar skills

Turborepo

Optimized build system for JavaScript/TypeScript monorepos.

Azure Pipelines Validation

Streamline your Azure DevOps pipeline changes locally.

Azure Developer CLI

Streamline your Azure project workflows with best practices.

Azure Container Registry CLI

Manage Azure Container Registry resources with ease.

Aspire

Build and orchestrate polyglot distributed applications seamlessly.

Vercel CLI

Manage and deploy Vercel projects from the command line.