k8s-debug

Diagnose Kubernetes clusters, pods, services, and deployments with Python and Bash scripts.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/sudohakan/claude-code-dotfiles --skill k8s-debug-sudohakan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: k8s-debug
Source: https://github.com/sudohakan/claude-code-dotfiles/tree/main/config/skills/cc-devops-skills/devops-skills-plugin/skills/k8s-debug
Command: npx skills add https://github.com/sudohakan/claude-code-dotfiles --skill k8s-debug-sudohakan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a comprehensive toolkit to systematically diagnose and resolve issues within Kubernetes clusters, ensuring smooth operation and rapid issue resolution.

Core Features & Use Cases

  • Automated Diagnostics: Run scripts to gather detailed information about pod status, cluster health, and network connectivity.
  • Systematic Workflow Guidance: Follow step-by-step guides for common issues like Pending pods, CrashLoopBackOff, and network failures.
  • Use Case: When a critical deployment is failing, use this Skill to quickly identify the root cause by running cluster_health.sh and then pod_diagnostics.py on the affected pods.

Quick Start

Use the k8s-debug skill to run a comprehensive health check on your Kubernetes cluster.

Frequently Asked Questions about k8s-debug

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

FAQPage Schema
How do I debug Kubernetes pods stuck in CrashLoopBackOff or Pending states?

To debug Kubernetes pods in CrashLoopBackOff or Pending states, run automated diagnostic scripts like pod_diagnostics.py to gather detailed status information and follow systematic workflow guides to identify the root cause.

What is the best way to run a comprehensive Kubernetes cluster health check?

The best way to run a Kubernetes cluster health check is using automated Bash scripts like cluster_health.sh, which gather detailed diagnostic data on cluster health degradation and network connectivity for rapid issue resolution.

Do I need jq installed to troubleshoot Kubernetes cluster issues with this toolkit?

Yes, you need jq installed to troubleshoot Kubernetes cluster issues with this toolkit, as it is a required dependency for parsing and processing the JSON diagnostic data gathered by the scripts.

How does automated pod diagnostics work for failing Kubernetes deployments?

Automated pod diagnostics for failing Kubernetes deployments works by executing Python and Bash scripts that collect and analyze detailed status information, network connectivity, and configuration data to pinpoint failure causes.

Can I use these diagnostic scripts to troubleshoot Kubernetes network connectivity problems?

Yes, you can use these diagnostic scripts to troubleshoot Kubernetes network connectivity problems by systematically gathering data on services and deployments to isolate network failures and resolve connectivity issues.