debug-pod

Diagnose OpenShift pod failures by collecting status, events, logs, and resource information.

48|31|Updated Feb 2, 2026
One-click install
npx skills add https://github.com/RHEcosystemAppEng/agentic-plugins --skill debug-pod
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-pod
Source: https://github.com/RHEcosystemAppEng/agentic-plugins/tree/main/rh-developer/skills/debug-pod
Command: npx skills add https://github.com/RHEcosystemAppEng/agentic-plugins --skill debug-pod

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the diagnosis of pod failures on OpenShift, simplifying the troubleshooting process for common issues like CrashLoopBackOff, ImagePullBackOff, OOMKilled, and pending pods.

Core Features & Use Cases

  • Automated Diagnosis: Automatically gather pod status, events, logs, and resource information to identify the root cause of pod failures.
  • Use Case: When a pod is not running, restarting frequently, or stuck in a non-ready state, use this Skill to diagnose the issue quickly.

Quick Start

Use the /debug-pod skill to diagnose pod failures on OpenShift by providing the pod name.

Frequently Asked Questions about debug-pod

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

FAQPage Schema
How do I diagnose pod failures like CrashLoopBackOff on an OpenShift cluster?

Diagnosing pod failures like CrashLoopBackOff on an OpenShift cluster requires gathering pod status, events, logs, and resource information. Automating this collection process quickly identifies the root cause of common pod failures.

What is the best way to automate OpenShift pod troubleshooting for pending pods?

The best way to automate OpenShift pod troubleshooting for pending pods is to use a diagnostic Skill that aggregates resource information and cluster events to pinpoint why the pod remains in a non-ready state.

How do I check OpenShift pod logs and events to find the root cause of OOMKilled errors?

To find the root cause of OOMKilled errors, you check OpenShift pod logs and events by collecting detailed resource information alongside the pod status to identify memory constraints causing the failure.

Do I need special permissions to diagnose ImagePullBackOff issues in an OpenShift cluster?

Yes, diagnosing ImagePullBackOff issues in an OpenShift cluster requires appropriate permissions and direct access to the cluster to retrieve the necessary status, events, and resource data for the failing pods.

Can I collect resource information for multiple restarting pods in OpenShift automatically?

You can collect resource information for restarting pods in OpenShift automatically by running a diagnostic script that aggregates cluster events and logs, simplifying the troubleshooting process for frequently restarting workloads.