rca:hypershift

Inspect live Hypershift cluster pods, logs, secrets, and configurations to trace failure origins.

292|103|Updated Mar 27, 2025
One-click install
npx skills add https://github.com/kagenti/kagenti --skill rca-hypershift
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rca:hypershift
Source: https://github.com/kagenti/kagenti/tree/main/.claude/skills/rca%3Ahypershift
Command: npx skills add https://github.com/kagenti/kagenti --skill rca-hypershift

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a systematic approach to diagnosing and resolving complex issues within a live Kubernetes (Hypershift) cluster when automated CI checks are insufficient.

Core Features & Use Cases

  • Live Cluster Inspection: Gain full access to pods, logs, secrets, and configurations in a running Hypershift cluster.
  • Systematic RCA Workflow: Follows a phased approach (Observe, Inspect, Reproduce, Trace, Document) for thorough root cause analysis.
  • Context-Safe Execution: Ensures all potentially noisy command outputs are redirected to files to maintain a clean main context.
  • Use Case: When a deployed agent is intermittently failing in production and rca:ci logs are inconclusive, use rca:hypershift to directly inspect the live pod state, examine configurations, and trace the request flow within the cluster to pinpoint the exact failure point.

Quick Start

Use the rca:hypershift skill to investigate a failing pod named 'weather-service' in the 'team1' namespace by checking its logs and status.

Frequently Asked Questions about rca:hypershift

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

FAQPage Schema
How do I perform root cause analysis on a live Kubernetes Hypershift cluster?

You can perform root cause analysis on a live Kubernetes Hypershift cluster by inspecting pods, logs, secrets, and configurations through a phased diagnostic workflow that observes, inspects, reproduces, traces, and documents failure origins.

When should I inspect live cluster pods instead of relying on CI logs?

You should inspect live cluster pods instead of relying on CI logs when automated checks are inconclusive, such as when a deployed agent is intermittently failing in production and you need to examine the live pod state to find the exact failure point.

Does troubleshooting Hypershift failures require direct cluster access?

Yes, troubleshooting complex Hypershift failures requires direct cluster access to thoroughly investigate live pods, examine configurations, and trace request flow within the cluster to identify failure origins that CI logs cannot resolve.

What is the best way to investigate intermittent production failures in Kubernetes?

The best way to investigate intermittent production failures in Kubernetes is to follow a phased diagnostic workflow—Observe, Inspect, Reproduce, Trace, and Document—allowing deep investigation into multi-component failures within the live cluster.

How do I keep the main context clean when inspecting Kubernetes pod logs?

To keep the main context clean when inspecting Kubernetes pod logs, redirect all potentially noisy command outputs to files, ensuring that the systematic root cause analysis workflow maintains a clean main context during execution.