kubernetes-troubleshoot

Diagnose Kubernetes pod failures and inspect cluster resources.

1|Updated Dec 4, 2025
One-click install
npx skills add https://github.com/timbuchinger/loadout --skill kubernetes-troubleshoot
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: kubernetes-troubleshoot
Source: https://github.com/timbuchinger/loadout/tree/main/skills/kubernetes-troubleshoot
Command: npx skills add https://github.com/timbuchinger/loadout --skill kubernetes-troubleshoot

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill simplifies the complex task of troubleshooting and managing Kubernetes clusters by providing a structured approach to resource inspection, debugging, and operations. It helps you quickly understand and resolve common pod and cluster issues.

Core Features & Use Cases

  • Resource Inspection: Guides in listing and describing pods, deployments, namespaces, and nodes.
  • Pod Failure Analysis: Helps diagnose common issues like CrashLoopBackOff, ImagePullBackOff, and pending pods.
  • Tool Preference: Prioritizes efficient MCP server tools for common read operations, falling back to kubectl when necessary.
  • Use Case: Your 'web-app' pod in the 'frontend' namespace is stuck in CrashLoopBackOff. This Skill guides you through checking pod events, logs, and descriptions to identify the root cause and suggest next steps.

Quick Start

List all pods in the 'default' namespace and show their current status, then get the logs for pod 'my-app-xyz'.

Frequently Asked Questions about kubernetes-troubleshoot

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

FAQPage Schema
How do I troubleshoot a pod stuck in CrashLoopBackOff in Kubernetes?

Troubleshoot CrashLoopBackOff by inspecting pod events, retrieving container logs, and describing the pod resource to identify application crashes or configuration errors. Check for mismatched image versions, missing environment variables, or resource constraints causing repeated failures.

How do I diagnose ImagePullBackOff errors in my Kubernetes cluster?

Diagnose ImagePullBackOff by describing the pod to view pull error details, checking image registry credentials and availability, and reviewing node events. Verify the image URI is correct, the registry is accessible, and pull secrets are properly configured in your namespace.

How do I retrieve logs from a specific pod in Kubernetes?

Retrieve pod logs by using kubectl or MCP tools to fetch container output for debugging. Specify the namespace, pod name, and optionally the container name to access current or previous logs from failed containers.

Can I inspect multiple Kubernetes resources across different namespaces and contexts?

Yes, you can scope resource inspection across namespaces and contexts to diagnose issues in multi-cluster environments. List and describe pods, deployments, nodes, and events while switching between namespaces and cluster contexts for complete visibility.

What's the best approach to debug pending pods in Kubernetes?

Debug pending pods by listing pod status, inspecting pod events for scheduling constraints, and describing node resources. Check for insufficient CPU/memory, taints, or affinity rules preventing pod placement on available nodes.

Does this troubleshooting approach work with multi-cluster Kubernetes environments?

Yes, the troubleshooting workflow supports single and multi-cluster environments through context and namespace scoping. Guide stepwise debugging across multiple clusters by switching contexts and targeting specific namespaces for pod and workload inspection.