k8s-troubleshooting

Diagnose and remediate Kubernetes and OpenShift cluster issues with a repeatable workflow.

3|Updated Jan 24, 2026
One-click install
npx skills add https://github.com/kcns008/cluster-skills --skill k8s-troubleshooting
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: k8s-troubleshooting
Source: https://github.com/kcns008/cluster-skills/tree/main/.claude/skills/k8s-troubleshooting
Command: npx skills add https://github.com/kcns008/cluster-skills --skill k8s-troubleshooting

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables systematic diagnosis and remediation of Kubernetes and OpenShift cluster issues, improving mean time to resolution and cluster reliability.

Core Features & Use Cases

  • Comprehensive health assessment: Proactively evaluate node, pod, network, storage, and RBAC health using Popeye-style checks and OpenShift-specific diagnostics.
  • In-depth troubleshooting workflow: Analyze events, logs, and resource status to identify root causes for pod failures, scheduling problems, and service connectivity.
  • OpenShift-focused guidance: Include SCC, Route, BuildConfig, and image stream checks specific to OpenShift environments.

Quick Start

Run the quick diagnostic commands to start assessing your cluster: kubectl get pods -A; kubectl get events -A --sort-by='.lastTimestamp'

Frequently Asked Questions about k8s-troubleshooting

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

FAQPage Schema
How do I troubleshoot Kubernetes pod failures and scheduling problems?

Diagnose Kubernetes pod failures by systematically analyzing cluster events, logs, and resource status to identify root causes. This skill applies a repeatable diagnostic workflow using context gathering and best-practice validations to resolve scheduling problems.

What is the best way to proactively check Kubernetes cluster health?

Proactively check Kubernetes cluster health by evaluating node, pod, network, storage, and RBAC status. This skill applies Popeye-style checks and OpenShift-specific diagnostics to assess cluster health and improve reliability.

Can I use this to troubleshoot OpenShift-specific issues like SCC and Routes?

Yes, you can troubleshoot OpenShift-specific issues including Security Context Constraints, Routes, BuildConfigs, and image streams. The skill provides focused diagnostic guidance to remediate issues unique to OpenShift cluster environments.

How does Kubernetes diagnostics handle service connectivity and networking issues?

Kubernetes diagnostics handle service connectivity by gathering context through commands like kubectl get events to analyze network failures. The skill systematically evaluates networking issues across clusters and cloud environments to pinpoint root causes.

What kubectl commands do I need to start diagnosing cluster issues?

Start diagnosing cluster issues by running kubectl get pods -A and kubectl get events -A --sort-by='.lastTimestamp' to gather initial context. These quick diagnostic commands evaluate pod status and recent cluster events for troubleshooting.