debug:kubernetes

Diagnose Kubernetes issues across clusters, pods, services, and RBAC configurations.

9|1|Updated Jan 12, 2026
One-click install
npx skills add https://github.com/SnakeO/claude-debug-and-refactor-skills-plugin --skill debug-kubernetes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug:kubernetes
Source: https://github.com/SnakeO/claude-debug-and-refactor-skills-plugin/tree/main/plugins/debug-and-refactor/skills/debug-kubernetes
Command: npx skills add https://github.com/SnakeO/claude-debug-and-refactor-skills-plugin --skill debug-kubernetes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Diagnose Kubernetes issues across clusters, pods, services, and RBAC configurations.

Core Features & Use Cases

  • Four-phase debugging methodology: Phase 1 Gather Information, Phase 2 Logs and Metrics, Phase 3 Interactive Investigation, Phase 4 Validate and Fix.
  • Covers common error patterns such as CrashLoopBackOff, ImagePullBackOff, Pending Pods, Service Not Reachable, PVC Binding Failures, and RBAC Denied errors.
  • Use Case: When a deployment fails, follow the guided steps to identify root causes across pod status, events, networking, and storage.

Quick Start

Initiate the kubectl-based debugging workflow for a failing pod in a given namespace to start resolving issues.

Frequently Asked Questions about debug:kubernetes

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I troubleshoot a Kubernetes pod stuck in CrashLoopBackOff?

To troubleshoot a Kubernetes pod in CrashLoopBackOff, follow a four-phase methodology: gather information, analyze logs and metrics, investigate interactively using ephemeral containers, and validate the fix. This structured approach identifies root causes across pod status and events.

What is the best way to debug Kubernetes RBAC denied errors in multi-namespace environments?

The best way to debug Kubernetes RBAC denied errors is to apply a structured workflow that diagnoses RBAC configurations across multi-namespace environments. It guides you through information gathering and interactive investigation to resolve complex permission issues.

How do I use kubectl to diagnose Kubernetes service connectivity problems?

You can use kubectl to diagnose Kubernetes service connectivity problems by following a guided workflow that executes one-liner diagnostics. It systematically checks pod status, network events, and service configurations to locate the connectivity failure.

Can I use ephemeral containers to investigate Pending Pods and PVC binding failures?

Yes, you can use ephemeral containers to investigate Pending Pods and PVC binding failures. The interactive investigation phase deploys these containers to inspect resource errors and storage configurations directly within the affected namespace.

Why are my Kubernetes pods failing with ImagePullBackOff and how do I fix it?

Kubernetes pods fail with ImagePullBackOff due to image retrieval errors. To fix it, the troubleshooting workflow analyzes cluster events and pod status during the logs and metrics phase to identify the exact missing image or registry authentication issue.