Trail of Bits

Debug Buttercup — Development skill for Claude Code

Development community Advanced

Trail of Bits security skill for debug buttercup.

How to install Debug Buttercup

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.

What Debug Buttercup does

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

Alternatives in Development

Octo Debug — Systematic debugging with methodical problem investigation 2.8k ★
Lsp Debug — LSP Debug Skill 1.9k ★
Android Rpc — Android Debug RPC 1.3k ★

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