kubernetes-troubleshooting

Diagnose Kubernetes pod, service, deployment, and node issues with kubectl.

5|1|Updated Feb 4, 2026
One-click install
npx skills add https://github.com/latestaiagents/agent-skills --skill kubernetes-troubleshooting-latestaiagents
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kubernetes-troubleshooting
Source: https://github.com/latestaiagents/agent-skills/tree/main/plugins/devops-sre/skills/automation/kubernetes-troubleshooting
Command: npx skills add https://github.com/latestaiagents/agent-skills --skill kubernetes-troubleshooting-latestaiagents

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a systematic approach to diagnose and resolve common issues within Kubernetes clusters, ensuring your applications remain available and performant.

Core Features & Use Cases

  • Pod Troubleshooting: Quickly identify and fix issues like CrashLoopBackOff, ImagePullBackOff, and Pending states.
  • Networking Debugging: Resolve problems with Services, Ingress, and network policies.
  • Deployment Analysis: Troubleshoot failing rollouts and identify deployment bottlenecks.
  • Node Health Checks: Diagnose issues related to node readiness and resource pressure.
  • Use Case: When a critical deployment fails to roll out, use this Skill to systematically check pod events, logs, and resource constraints to pinpoint the cause and implement a fix.

Quick Start

Use the kubernetes-troubleshooting skill to help debug a pod named 'my-app-pod' in the 'production' namespace that is stuck in a CrashLoopBackOff state.

Frequently Asked Questions about kubernetes-troubleshooting

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 systematically checking pod events and container logs to identify application crashes or misconfigurations. This approach helps pinpoint failing commands or missing dependencies causing the restart loop.

Why is my Kubernetes pod stuck in a Pending state?

A Kubernetes pod stuck in Pending indicates scheduling failures, often caused by insufficient cluster resources or unschedulable node constraints. Diagnosing this requires checking pod events and node health to identify resource pressure or affinity mismatches.

How do I resolve Kubernetes service and ingress networking failures?

Resolve Kubernetes service and ingress networking failures by debugging connectivity issues across services and network policies. This process diagnoses misconfigured routing rules or missing endpoints that prevent traffic from reaching target pods.

Do I need kubectl to troubleshoot Kubernetes node health issues?

Yes, you need kubectl to troubleshoot Kubernetes node health issues, as it provides the commands required to check node readiness and resource pressure. An understanding of Kubernetes resource objects is also necessary to interpret the diagnostics.

What is the best way to diagnose ImagePullBackOff errors in Kubernetes?

The best way to diagnose ImagePullBackOff errors in Kubernetes is to inspect pod events to reveal image pull failures. This troubleshooting step identifies missing image tags, incorrect registry names, or lacking authentication credentials.