k8s-debug

Diagnose Kubernetes pod issues like CrashLoopBackOff and ImagePullBackOff.

Updated Apr 20, 2026
One-click install
npx skills add https://github.com/vincent119/ai-rules-kit --skill k8s-debug-vincent119
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: k8s-debug
Source: https://github.com/vincent119/ai-rules-kit/tree/main/skills/k8s-debug
Command: npx skills add https://github.com/vincent119/ai-rules-kit --skill k8s-debug-vincent119

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Quickly diagnose and triage Kubernetes pod issues across clusters, reducing mean time to recovery.

Core Features & Use Cases

  • Pod status and event analysis to identify failures such as CrashLoopBackOff, ImagePullBackOff, and OOMKilled.
  • Log retrieval for current and previous container runs to pinpoint root causes.
  • In-cluster debugging: exec into containers, inspect environment, and validate networking and readiness.
  • Port-forward and resource monitoring to validate service access and performance.
  • Use Case: When a deployment fails to become ready, walk through a structured workflow to isolate the issue and propose remediation steps.

Quick Start

Describe the Kubernetes pod issue you are facing and I will guide you through a structured debugging workflow.

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 stuck in CrashLoopBackOff?

Debugging a Kubernetes pod in CrashLoopBackOff requires retrieving previous container logs and analyzing recent pod events. This skill enforces a structured workflow to isolate the root cause by inspecting runtime errors and environment configurations safely without applying destructive changes.

What is the best way to troubleshoot ImagePullBackOff errors in kubectl?

Troubleshooting ImagePullBackOff errors in kubectl involves checking pod status and events to identify image name or registry credential issues. This skill guides you through evaluating kubectl event outputs to pinpoint the exact failure and propose safe remediation steps.

How do I find out why my Kubernetes deployment is not ready?

Finding out why a Kubernetes deployment is not ready requires analyzing pod status, events, and readiness probes. This skill walks you through a structured debugging workflow to identify readiness problems, inspect container environments, and validate service access via port-forwarding.

Can I use this workflow to debug pods across CI pipelines and development environments?

Yes, you can use this workflow to debug pods across CI pipelines and development environments. The skill applies to live clusters and various contexts by enforcing cluster context awareness and safe kubectl usage to triage issues like OOMKilled without risking destructive changes.

Does this Kubernetes debugging process support exec into containers and resource monitoring?

Yes, this Kubernetes debugging process supports using exec to enter containers, inspect environments, and validate networking. It also includes resource monitoring and port-forward capabilities to validate service access and performance while maintaining safe debugging steps.