kubernetes-debugging

Diagnose Kubernetes pod failures using kubectl commands and logs.

1|Updated Feb 11, 2026

Search Tags:#debugging #logs #kubernetes #kubectl #events #pods #ephemeral-containers

Ready to run

npx skills add https://github.com/jander99/skills --skill kubernetes-debugging

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: kubernetes-debugging
Source: https://github.com/jander99/skills/tree/main/skills/kubernetes-debugging
Command: npx skills add https://github.com/jander99/skills --skill kubernetes-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Diagnose and troubleshoot Kubernetes workloads quickly using safe kubectl inspection commands to resolve pod failures, deployment hang-ups, and service issues.

Core Features & Use Cases

Interpret pod statuses and diagnose root causes (OOMKilled, CrashLoopBackOff, ImagePullBackOff)
Retrieve and analyze container logs, including previous crash logs
Debug scheduling, resource constraints, and network connectivity
Use ephemeral debug containers for distroless or crashed pods
Use cases: when pods are not starting, deployments stall, or services are misbehaving

Quick Start

Use kubectl to describe the pod and fetch logs to diagnose issues.

Frequently Asked Questions about kubernetes-debugging

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

FAQPage Schema

How do I debug a Kubernetes pod stuck in CrashLoopBackOff?▼

Debug a Kubernetes pod stuck in CrashLoopBackOff by using kubectl to describe the pod and retrieve previous crash logs. Inspecting these logs reveals the root cause of the container failure.

What is the best way to retrieve logs from a crashed Kubernetes pod?▼

Retrieve logs from a crashed Kubernetes pod using kubectl to fetch previous container output. This provides the crash context needed to diagnose the workload failure.

How do I debug distroless Kubernetes pods that lack a shell?▼

Debug distroless Kubernetes pods by attaching an ephemeral debug container using kubectl. This allows safe inspection without modifying the original container image.

How do I diagnose Kubernetes pods failing with OOMKilled or ImagePullBackOff statuses?▼

Diagnose OOMKilled or ImagePullBackOff pod statuses by interpreting the pod events with kubectl. This identifies resource constraints or scheduling issues causing the failure.

Can I troubleshoot Kubernetes deployment rollouts and service outages using kubectl?▼

Troubleshoot Kubernetes deployment rollouts and service outages using kubectl inspection commands. You can diagnose misconfigurations and resolve stalled workloads safely.

Why is my Kubernetes pod not starting and how do I check scheduling constraints?▼

Check Kubernetes pod scheduling constraints by describing the pod with kubectl. This reveals node resource limitations or network connectivity issues preventing startup.