k8s-debug-workload

Diagnose Kubernetes workload failures by analyzing pod status, events, logs, and node constraints.

9|3|Updated Jun 13, 2026
One-click install
npx skills add https://github.com/Sir-chawakorn/sanook-cli --skill k8s-debug-workload
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: k8s-debug-workload
Source: https://github.com/Sir-chawakorn/sanook-cli/tree/main/skills/k8s-debug-workload
Command: npx skills add https://github.com/Sir-chawakorn/sanook-cli --skill k8s-debug-workload

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill resolves the frustration of troubleshooting broken Kubernetes workloads by providing a structured, step-by-step diagnostic path for common failures like CrashLoopBackOff, OOMKilled, and stuck deployments.

Core Features & Use Cases

  • Root Cause Analysis: Automatically guides you through checking events, logs, and node status to pinpoint why a pod is failing.
  • Failure Isolation: Differentiates between scheduling issues, image pull errors, probe failures, and service connectivity problems.
  • Use Case: When a deployment is stuck in a CrashLoopBackOff state, use this skill to identify whether the issue is a memory limit, a failed liveness probe, or a missing configuration file.

Quick Start

Use the k8s-debug-workload skill to diagnose the failing pod named web-server in the production namespace.

Frequently Asked Questions about k8s-debug-workload

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

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

To debug a Kubernetes pod stuck in CrashLoopBackOff, systematically analyze pod status, events, and logs to pinpoint the root cause. This isolates whether the failure stems from a memory limit, failed liveness probe, or missing configuration file.

Why is my Kubernetes workload failing with OOMKilled or ImagePullBackOff errors?

Kubernetes workloads fail with OOMKilled or ImagePullBackOff errors due to resource constraints or image fetching issues. A systematic diagnostic process checks node constraints and specific failure modes to differentiate between scheduling problems and image pull errors.

Do I need kubectl access to troubleshoot failing Kubernetes deployments?

Yes, you need kubectl access to troubleshoot failing Kubernetes deployments. Diagnosing live workload failures requires executing diagnostic commands against specific namespaces and objects within the cluster to retrieve events, logs, and node status.

What is the best way to isolate Kubernetes service endpoint mismatches?

The best way to isolate Kubernetes service endpoint mismatches is to follow a structured diagnostic path that checks service connectivity problems. This differentiates scheduling issues and probe failures from actual service connectivity mismatches.

How do I diagnose a stuck Kubernetes deployment in a production namespace?

To diagnose a stuck Kubernetes deployment in a production namespace, systematically analyze pod status, events, logs, and node constraints. This step-by-step diagnostic path targets specific failure modes like CrashLoopBackOff and OOMKilled to identify the root cause.