debug-buttercup

Diagnose Kubernetes pod issues by analyzing Redis, queues, and logs.

6.5k|561|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/trailofbits/skills --skill debug-buttercup-trailofbits
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-buttercup
Source: https://github.com/trailofbits/skills/tree/main/plugins/debug-buttercup/skills/debug-buttercup
Command: npx skills add https://github.com/trailofbits/skills --skill debug-buttercup-trailofbits

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Diagnose pod crashes, restarts, and other service issues in the Buttercup's crs namespace by analyzing logs, events, and resources.

Core Features & Use Cases

  • Pod Status: View pod status and resource usage.
  • Redis Health: Monitor Redis performance and persistence settings.
  • Queue Inspection: Analyze queue lengths and task progress.
  • Log Analysis: Extract logs for deeper analysis of specific services or pods.
  • Use Case: When multiple pods in the crs namespace restart simultaneously or when Redis becomes unresponsive, use this skill to diagnose and address the underlying issue.

Quick Start

To start diagnosing the system, run: bash /scripts/diagnose.sh

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 pods that keep restarting in a specific namespace?

To diagnose Kubernetes pods restarting in a specific namespace, you can run a diagnostic script that collects system status, analyzes Redis health, inspects task queues, and extracts pod logs to generate a comprehensive diagnostic report identifying the underlying issue.

What is the best way to monitor Redis health and queue lengths during a pod crash?

Monitoring Redis health and queue lengths during a pod crash involves using redis-cli to check performance metrics, verify persistence settings, and analyze task queue progress, helping pinpoint if an unresponsive Redis instance is causing service failures.

Can I use kubectl to troubleshoot simultaneous pod restarts and service failures?

Yes, you can use kubectl to troubleshoot simultaneous pod restarts and service failures by extracting event logs and viewing resource usage across affected pods, which helps determine if resource exhaustion or application errors triggered the crashes.

Does this pod debugging approach require any external dependencies to run?

No external dependencies are required for this pod debugging approach, as it relies entirely on built-in command-line tools like kubectl and redis-cli alongside custom internal scripts to collect and analyze the diagnostic data.

Why are multiple pods in my crs namespace becoming unresponsive simultaneously?

Multiple pods in a crs namespace becoming unresponsive simultaneously often indicates an upstream dependency failure, such as Redis becoming unresponsive or task queues backing up, which can be verified by analyzing system status and queue lengths.

What limitations should I expect when running custom diagnostic scripts for log analysis?

When running custom diagnostic scripts for log analysis, limitations include being specifically designed for the crs namespace architecture, meaning the generated reports and diagnostic logic may not directly translate to other Kubernetes namespace configurations.