kubernetes-troubleshooting

Diagnose Kubernetes and OpenShift cluster health from logs, events, and diagnostics.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires kubectl, jq, and includes scripts (resource) components.

What problem does it solve?

This Skill provides structured analysis and troubleshooting for Kubernetes and OpenShift clusters, enabling proactive health checks, log analysis, and rapid issue resolution.

Core Features & Use Cases

  • Proactive health assessment: run health checks across nodes, pods, and cluster components to detect issues early.
  • Log and event analysis: inspect pod logs and events to identify root causes such as CrashLoopBackOff, image pull issues, DNS, or network problems.
  • OpenShift-specific diagnostics: diagnose SCCs, routes, operators, and builds to restore platform health.
  • Performance and RBAC validation: assess resource usage, limits, and access controls to optimize and secure clusters.

Quick Start

Instantiate the kubernetes-troubleshooting skill to scan a cluster and produce a health report, then run the included scripts for automated health checks.

Frequently Asked Questions about kubernetes-troubleshooting

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

FAQPage Schema
How do I troubleshoot Kubernetes pod failures like CrashLoopBackOff?

To troubleshoot Kubernetes pod failures like CrashLoopBackOff, analyze pod logs and events using the included diagnostic script. It identifies root causes such as image pull issues, DNS errors, or network problems to restore cluster health.

What is the best way to perform an OpenShift cluster health assessment?

An OpenShift cluster health assessment involves running proactive checks across nodes, pods, and operators. You can diagnose platform-specific components like SCCs, routes, and builds to detect issues early and validate overall cluster health.

Do I need kubectl and jq to diagnose Kubernetes RBAC issues?

Yes, you need kubectl and jq installed in your environment to diagnose Kubernetes RBAC issues. These standard tools are required dependencies to execute the deterministic checks and validate access controls within the cluster.

Can I use this for multi-cluster day-2 operations and storage analysis?

Yes, you can use this for multi-cluster day-2 operations and storage analysis. It provides structured diagnostics for cluster components, enabling you to assess resource usage, limits, and storage problems across multiple environments.

Why is my Kubernetes troubleshooting script not working in my environment?

Your Kubernetes troubleshooting script might not work if standard tooling like kubectl and jq is unavailable in your environment. These dependencies are required to execute the deterministic health checks and analyze cluster logs.