debug-capz-k8s

Official

Debug CAPZ Kubernetes cluster failures.

Authorkubernetes-sigs
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill provides a comprehensive approach to diagnosing and resolving failures in CAPZ (Cluster API Provider Azure) managed Kubernetes clusters, reducing downtime and troubleshooting time.

Core Features & Use Cases

  • Multi-faceted Debugging: Integrates live cluster inspection (kubectl), VM-level diagnostics (az CLI), Prow/GCS artifact analysis, and build log triage.
  • Deep CAPZ Knowledge: Understands CAPZ template flavors, E2E test structures, addon deployments (Calico, cloud-provider-azure, CSI), common failure patterns, and transient errors.
  • Use Case: When a CAPZ-provisioned workload cluster fails to become ready, this Skill can analyze Prow job logs, inspect the control plane and worker node VMs via az CLI, and examine CAPI resource states to pinpoint the root cause, whether it's infrastructure, networking, or bootstrapping issues.

Quick Start

Use the debug-capz-k8s skill to analyze the failing CAPZ E2E test run from the provided Prow URL.

Dependency Matrix

Required Modules

None required

Components

scriptsreferences

💻 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: debug-capz-k8s
Download link: https://github.com/kubernetes-sigs/cluster-api-provider-azure/archive/main.zip#debug-capz-k8s

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 223,000+ vetted skills library on demand.