openshift-expert

Diagnose OpenShift CI test failures and cluster issues with must-gather data.

9|43|Updated Apr 11, 2023
One-click install
npx skills add https://github.com/openshift/release-tests --skill openshift-expert
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openshift-expert
Source: https://github.com/openshift/release-tests/tree/main/.claude/skills/openshift-expert
Command: npx skills add https://github.com/openshift/release-tests --skill openshift-expert

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill provides deep OpenShift platform expertise for test failure analysis, cluster troubleshooting, and root cause determination, helping teams diagnose issues faster and reduce complexity.

Core Features & Use Cases

  • 🔍 Failure Pattern Recognition and Diagnosis for OpenShift/Kubernetes issues
  • 🧭 Cluster State Analysis and Must-gather interpretation
  • 🧠 Root Cause Analysis Framework with evidence and recommended actions
  • 🛠️ Targeted Troubleshooting guidance for operators, networking, storage, and CI/CD pipelines
  • Use Case: When a Prow job fails, Claude-OpenShift can analyze logs, events, and cluster state to determine root cause and actionable next steps.

Quick Start

Use the openshift-expert skill to analyze a CI test failure by providing must-gather data and live cluster logs.

Frequently Asked Questions about openshift-expert

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

FAQPage Schema
How do I troubleshoot OpenShift cluster failures and CI test breakages?

OpenShift troubleshooting uses must-gather diagnostics and cluster logs to identify root causes. This Skill analyzes failure patterns across operators, networking, storage, and CI/CD pipelines to surface actionable remediation steps tied to specific cluster state evidence.

What's the best way to interpret must-gather data from a failed Prow job?

Must-gather interpretation structures cluster state, events, and logs into a diagnostic framework. This Skill recognizes failure patterns in Prow outputs, maps symptoms to root causes, and generates targeted troubleshooting guidance for operators and cluster components.

Can I diagnose operator degradation and networking issues in Kubernetes clusters?

Yes. Root cause analysis across operators, networking, and storage applies to both OpenShift and Kubernetes environments. This Skill identifies degradation patterns, correlates cluster state signals, and recommends specific remediation actions.

How do I reduce time spent debugging cluster test failures?

Fast diagnosis combines failure-pattern recognition with structured root-cause analysis. This Skill accelerates turnaround by automatically activating on CI failures, analyzing logs and cluster state, and delivering evidence-backed remediation guidance without manual pattern-hunting.

What information should I provide to analyze an OpenShift cluster issue?

Provide must-gather archives and live-cluster logs; these supply cluster state, events, and operator status. The Skill processes this diagnostic data to perform root-cause analysis and generate actionable next steps for resolution.