k8s-debug

Diagnose Kubernetes pod failures, network issues, and cluster health with kubectl and Python 3.

290|32|Updated Dec 5, 2025
One-click install
npx skills add https://github.com/akin-ozer/cc-devops-skills --skill k8s-debug-akin-ozer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: k8s-debug
Source: https://github.com/akin-ozer/cc-devops-skills/tree/main/devops-skills-plugin/skills/k8s-debug
Command: npx skills add https://github.com/akin-ozer/cc-devops-skills --skill k8s-debug-akin-ozer

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill enables operators to diagnose and troubleshoot Kubernetes clusters quickly, consolidating diagnostic workflows and reducing mean time to recovery when pods fail, services misbehave, or cluster health deteriorates.

Core Features & Use Cases

  • Pod diagnostics: gather status, events, logs, and resource usage to identify failure modes.
  • Cluster health checks: assess node readiness, component status, and resource pressure to spot systemic issues.
  • Network and service debugging: validate DNS resolution, endpoints, and service reachability across namespaces; Use Case: when a pod crashes and services are unreachable, run the provided scripts to collect diagnostics and generate a consolidated report.

Quick Start

Run pod diagnostics for a failing pod: python3 scripts/pod_diagnostics.py <pod-name> -n <namespace>

Frequently Asked Questions about k8s-debug

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

FAQPage Schema
How do I debug a Kubernetes pod that keeps crashing?

To debug a crashing Kubernetes pod, you need to gather its status, events, and logs. This Skill runs diagnostic scripts via kubectl to collect failure details and resource usage, generating a consolidated report to identify the exact failure mode.

What is the best way to check Kubernetes cluster health and node readiness?

Checking Kubernetes cluster health involves assessing node readiness, component status, and resource pressure. This Skill executes targeted diagnostics to spot systemic issues across your deployment, helping you quickly understand if nodes are under resource pressure.

How do I troubleshoot Kubernetes service and DNS resolution issues across namespaces?

Troubleshooting Kubernetes network issues requires validating DNS resolution, endpoints, and service reachability across namespaces. This Skill applies network debugging scripts against your live cluster to verify connectivity and identify why services are unreachable.

Do I need kubectl and Python 3 installed to run Kubernetes diagnostics?

Yes, you need both kubectl and Python 3 installed to execute these Kubernetes diagnostics. The Skill relies on Python scripts that invoke kubectl commands to query your live cluster for pod statuses, events, logs, and network endpoint data.

Can I diagnose multiple Kubernetes namespaces at the same time?

Yes, you can diagnose multiple Kubernetes namespaces simultaneously. The Skill is designed to validate service reachability, endpoints, and pod failures across multi-namespace deployments, providing a consolidated diagnostic report for your entire cluster.

Kubernetes pod diagnostics are not showing enough detail, what are the limitations?

The limitation of Kubernetes pod diagnostics depends on the live cluster data accessible via kubectl. This Skill gathers available status, events, logs, and resource usage, but cannot retrieve information missing from the cluster's own recorded event history.