debug-buttercup

Diagnoses and resolves Buttercup Cyber Reasoning System Kubernetes operational failures.

Updated Nov 23, 2025
One-click install
npx skills add https://github.com/manuelbrandner85/Weltenbibliothekapp --skill debug-buttercup-manuelbrandner85
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-buttercup
Source: https://github.com/manuelbrandner85/Weltenbibliothekapp/tree/main/.agents/skills/debug-buttercup
Command: npx skills add https://github.com/manuelbrandner85/Weltenbibliothekapp --skill debug-buttercup-manuelbrandner85

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This skill provides a structured triage and diagnostic framework for the Buttercup Cyber Reasoning System (CRS) running on Kubernetes, helping engineers quickly identify and resolve service crashes, resource pressure, and queue stalls.

Core Features & Use Cases

  • Automated Triage: Quickly identify pod restart patterns, event warnings, and resource bottlenecks across the crs namespace.
  • Redis & Queue Monitoring: Inspect stream lengths, consumer group lag, and task registry health to resolve processing backlogs.
  • Use Case: When the fuzzer-bot and scheduler services enter a crash loop, use this skill to determine if the root cause is a Redis connection failure or disk saturation, and execute the diagnostic script to gather a full system snapshot.

Quick Start

Run the diagnostic script to generate a full report of the current system state including logs and resource usage.

Frequently Asked Questions about debug-buttercup

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

FAQPage Schema
How do I diagnose Kubernetes pod crash loops in the Buttercup CRS namespace?

Diagnose Kubernetes pod crash loops by running the diagnostic script to analyze pod restart patterns, inspect event warnings, and generate a full system snapshot of logs and resource usage across the crs namespace.

Why does my Redis stream consumer group lag cause fuzzer-bot queue backlogs?

Redis stream consumer group lag causes fuzzer-bot queue backlogs when task processing stalls. Inspect stream lengths, consumer group lag, and task registry health using kubectl to identify and resolve the processing backlog.

How do I troubleshoot resource contention and disk saturation affecting Kubernetes scheduler services?

Troubleshoot Kubernetes resource contention and disk saturation by inspecting pod resource limits, node capacity, and event warnings via kubectl to identify bottlenecks causing scheduler service disruptions.

Do I need kubectl access to perform SRE triage on a Cyber Reasoning System Kubernetes environment?

You need kubectl access and standard Linux utilities to perform SRE triage on a Cyber Reasoning System Kubernetes environment, enabling log analysis, resource inspection, and stream monitoring across the cluster.

What is the best way to monitor Redis queue health and identify task processing failures in Kubernetes?

The best way to monitor Redis queue health in Kubernetes is by inspecting stream lengths and consumer group lag through a structured diagnostic framework that queries the task registry and captures real-time stream metrics.

What should I do when my Buttercup CRS fuzzer-bot and scheduler services keep crashing?

When fuzzer-bot and scheduler services keep crashing, execute the diagnostic script to determine if the root cause is a Redis connection failure or disk saturation, then review the generated system state report.