debug-buttercup

Diagnose Buttercup CRS pod crashes and service failures on Kubernetes.

Updated Feb 24, 2026
One-click install
npx skills add https://github.com/ofelixdev/cc-kit --skill debug-buttercup-ofelixdev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-buttercup
Source: https://github.com/ofelixdev/cc-kit/tree/main/template/skills/debug-buttercup
Command: npx skills add https://github.com/ofelixdev/cc-kit --skill debug-buttercup-ofelixdev

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides a comprehensive guide and automated scripts to diagnose and resolve issues within the Buttercup Cyber Reasoning System (CRS) deployed on Kubernetes, helping to quickly identify and fix pod crashes, resource issues, and service misbehavior.

Core Features & Use Cases

  • Triage Workflow: Guides users through essential kubectl commands to identify pod status, events, and warnings.
  • Log Analysis: Provides commands to inspect current and previous container logs, stream live logs, and collect logs from multiple replicas.
  • Resource Monitoring: Offers tools to check pod and node resource usage, disk pressure, and in-pod disk space.
  • Redis Debugging: Detailed steps for diagnosing Redis health, including memory, persistence, client connections, and AOF configuration.
  • Queue Inspection: Lists key Redis stream keys and provides commands to check queue depths and consumer group lag.
  • Failure Pattern Reference: Links to detailed explanations of common failure modes like Redis AOF cascades, disk saturation, DinD issues, and OOM kills.
  • Automated Snapshot: Includes a diagnose.sh script to collect a snapshot of the CRS environment.

Quick Start

Run the automated triage snapshot script to collect diagnostic information for the Buttercup CRS.

Frequently Asked Questions about debug-buttercup

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

FAQPage Schema
How do I debug a Buttercup CRS pod crashing on Kubernetes?

To debug a Buttercup CRS pod crash on Kubernetes, use the triage workflow with kubectl commands to check pod status, inspect previous container logs, and review cluster warnings. An automated diagnostic script is also available to snapshot the environment.

How do I diagnose Redis memory and persistence issues in Kubernetes?

Diagnose Redis memory and persistence issues by checking Redis health metrics, monitoring client connections, and verifying AOF configuration. The Skill provides specific debugging steps to identify AOF cascades and memory pressure within the Buttercup CRS Kubernetes deployment.

What causes disk saturation and OOM kills in Kubernetes Cyber Reasoning Systems?

Disk saturation and OOM kills in Kubernetes Cyber Reasoning Systems are common failure patterns caused by resource pressure. The Skill references these specific failure modes and provides explanations to help identify node disk pressure and in-pod disk space exhaustion.

How do I check Redis stream queue depths and consumer group lag?

Check Redis stream queue depths and consumer group lag by running the specific Redis inspection commands provided. The Skill lists key Redis stream keys and offers commands to monitor queue backlogs and consumer lag within the CRS deployment.

Can I collect a full diagnostic snapshot of my Kubernetes environment for troubleshooting?

Yes, you can collect a full diagnostic snapshot of your Kubernetes environment by running the included diagnose.sh script. This automated triage tool snapshots the Buttercup CRS environment to streamline troubleshooting and resolve service misbehavior.