Debug Buttercup banner
Trail of Bits Trail of Bits

Debug Buttercup

Development community Advanced

Description

Debug the Buttercup CRS (Cyber Reasoning System) running on Kubernetes.

Installation

Installs to ~/.claude/skills/debug-buttercup/

Terminal
git clone --depth 1 https://github.com/trailofbits/skills /tmp/skills \ && mkdir -p ~/.claude/skills \ && cp -r /tmp/skills/plugins/debug-buttercup ~/.claude/skills/debug-buttercup

Clones the whole repository, because a skill folder can carry scripts and resources beside its SKILL.md.

Repository README

This is the README for trailofbits/skills, shared by 13 entries in this directory. It describes the repository, not this entry specifically.

debug-buttercup

Debug the Buttercup CRS (Cyber Reasoning System) running on Kubernetes.

Skills

Skill Description
debug-buttercup Diagnose pod crashes, restart loops, resource pressure, and service misbehavior for Buttercup Kubernetes deployments

What It Covers

  • Triage workflow: systematic approach starting with pod status, events, and warnings
  • Cascade detection: identifying shared-dependency failures (especially Redis) before investigating individual pods
  • Redis debugging: AOF issues, queue inspection, consumer group lag, memory diagnostics
  • Resource pressure: OOM kills, disk saturation, CPU throttling
  • Service-specific patterns: DinD failures, health check staleness, init container blocks
  • Diagnostic script: automated snapshot of cluster state, queue depths, and Redis health

Installation

/plugins install debug-buttercup