Skip to main content

Debug Buttercup

Skill Verified Active

Debugs the Buttercup CRS (Cyber Reasoning System) running on Kubernetes. Use when diagnosing pod crashes, restart loops, Redis failures, resource pressure, disk saturation, DinD issues, or any service misbehavior in the crs namespace. Covers triage, log analysis, queue inspection, and common failure patterns for: redis, fuzzer-bot, coverage-bot, seed-gen, patcher, build-bot, scheduler, task-server, task-downloader, program-model, litellm, dind, tracer-bot, merger-bot, competition-api, pov-reproducer, scratch-cleaner, registry-cache, image-preloader, ui.

Purpose

To help users quickly diagnose and resolve issues within Buttercup CRS deployments on Kubernetes by providing automated diagnostics and actionable troubleshooting steps.

Features

  • Automated triage script for Kubernetes.
  • Detailed guidance on diagnosing common Buttercup CRS failures.
  • Analysis of pod status, events, and resource utilization.
  • Specific debugging steps for Redis, queues, and core services.

Use Cases

  • Use when pods in the `crs` namespace are crashing or exhibiting unexpected behavior.
  • Use when diagnosing cascading failures originating from a shared dependency like Redis.
  • Use when investigating resource pressure or disk saturation issues within the `crs` namespace.
  • Use to inspect queue depths and task progression when services appear stalled.

Non-Goals

  • Deploying or upgrading Buttercup CRS (use Helm and deployment guides).
  • Debugging issues outside the `crs` Kubernetes namespace.
  • General Kubernetes administration or debugging unrelated to Buttercup CRS.

Documentation

  • info:Configuration & parameter referenceWhile the script uses environment variables like `BUTTERCUP_NAMESPACE`, these are documented in the script's usage comment, and explicit parameters are not a primary feature of this diagnostic script.

Installation

First, add the marketplace

/plugin marketplace add trailofbits/skills
/plugin install debug-buttercup@trailofbits

Quality Score

Verified
95 /100
Analyzed about 12 hours ago

Trust Signals

Last commit3 days ago
Stars5.2k
LicenseCC-BY-SA-4.0
Status
View Source

© 2025 SkillRepo · Find the right skill, skip the noise.