troubleshooting-kubernetes

Diagnose Kubernetes issues and present remediation options for user approval.

7|Updated Nov 27, 2025

Search Tags:#troubleshooting #remediation #kubernetes #interactive #kubectl #k8s

Ready to run

npx skills add https://github.com/galihcitta/dotclaudeskills --skill troubleshooting-kubernetes

💬 Prompt for ChatGPT / Claude Chat▼

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides operators through diagnosing and remediating Kubernetes issues with an interactive, approval-driven workflow. It helps identify root causes, proposes safe fixes, and ensures you confirm changes before applying them to avoid outages.

Core Features & Use Cases

Interactive remediation: Diagnose first, propose fixes, and wait for user approval.
State collection: Gather pods, services, deployments, and events to inform decisions.
Option-driven fixes: Present numbered fixes (e.g., scaling resources, adjusting limits, patching configs).
Safe enforcement: Never auto-apply changes; requires user confirmation.
Common issues covered: CrashLoopBackOff, ImagePullBackOff, Pending, 0/3 endpoints, deployment issues.

Quick Start

GET STATE: kubectl get pods, svc, deploy, events
IDENTIFY: match symptoms to known issues
DRILL DOWN: fetch logs and specific checks
OFFER FIX: review 2-4 remediation options
WAIT: choose an option (1-4)
APPLY & VERIFY: apply chosen fix and confirm resolution

Frequently Asked Questions about troubleshooting-kubernetes

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

FAQPage Schema

How do I diagnose and fix Kubernetes pod crashes like CrashLoopBackOff?▼

Kubernetes pod crashes including CrashLoopBackOff occur when containers repeatedly fail to start. This Skill collects pod logs and events, identifies the root cause (memory limits, missing configs, image issues), and presents numbered remediation options you approve before applying—ensuring safe, confirmed fixes without auto-changes.

How do I troubleshoot a Kubernetes service showing 502/503 errors or zero endpoints?▼

Service unavailability with empty endpoints typically stems from failed pod deployments or selector mismatches. This Skill gathers service, pod, and deployment state, diagnoses the underlying issue, and walks you through fix options—scaling resources, updating image pulls, or adjusting configs—before you confirm changes.

What's the best way to safely remediate stuck Kubernetes deployments?▼

Stuck deployments (ImagePullBackOff, Pending status) require diagnosis before action to avoid cascading failures. This Skill interactively identifies the blocker, proposes 2–4 remediation paths with clear explanations, waits for your selection, applies your chosen fix, and verifies resolution.

Can I troubleshoot multiple Kubernetes issues across pods, services, and deployments at once?▼

Yes. This Skill handles multi-layer Kubernetes issues by gathering state from pods, services, deployments, and events simultaneously, matching symptoms to common failure modes (OOMKilled, ImagePullBackOff, endpoint gaps), and presenting unified remediation options across your cluster.

Do I need kubectl access to use Kubernetes troubleshooting workflows?▼

Yes. This Skill relies on kubectl to query cluster state (pods, services, deployments, events) and apply fixes. You must have kubectl configured and cluster permissions to read diagnostics and execute remediation steps you approve.

Why should I use an interactive approval workflow instead of auto-applying Kubernetes fixes?▼

Interactive approval prevents unintended outages by letting you review root causes and fix options before changes deploy. This Skill diagnoses first, shows trade-offs, waits for your choice, then applies and verifies—keeping you in control of production changes.