forensic_surgeon

Diagnoses root causes of complex software failures via forensic debugging across application, library, and system boundaries.

4|1|Updated May 19, 2025
One-click install
npx skills add https://github.com/agentydragon/ducktape --skill forensic-surgeon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: forensic_surgeon
Source: https://github.com/agentydragon/ducktape/tree/main/nix/home/claude_code/skills/forensic_surgeon
Command: npx skills add https://github.com/agentydragon/ducktape --skill forensic-surgeon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deep forensic debugging that never stops until root cause is found or visibility limit is proven. Use when you want to understand exactly why something is broken, not just work around it.

Core Features & Use Cases

  • Obsessive, mechanistic debugging that traces through every layer (application → framework → library → syscall) to reveal the smoking gun.
  • Read actual source code, examine observability data, and document the investigation process across teams.
  • Use cases include incident investigations, post-mortems, and complex bug hunts with unclear symptoms.

Quick Start

Describe the issue, enable full observability, and begin the end-to-end root-cause investigation.

Frequently Asked Questions about forensic_surgeon

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

FAQPage Schema
How do I find the root cause of a complex software crash instead of just patching the symptom?

Root-cause debugging traces through every layer from application to framework to syscall, reading actual source code and observability data to reveal the exact mechanical failure. It requires a structured diagnostic workflow to prove the root cause or the visibility limit.

What is forensic debugging and when do I need it for incident investigations?

Forensic debugging is a mechanistic investigation that traces failures across application, library, and system boundaries. You need it for incident investigations, post-mortems, and complex bug hunts where symptoms are elusive or visibility gaps obscure the root cause.

How do I troubleshoot performance anomalies when standard observability data is unclear?

Troubleshooting performance anomalies requires examining observability data and source code systematically across all layers, including syscalls. A structured forensic diagnostic workflow guides the investigation end-to-end until the root cause is found or the visibility limit is definitively proven.

Do I need access to source code to diagnose system boundary failures?

Yes, diagnosing failures across application, framework, library, and syscall boundaries requires access to actual source code. Reading the source alongside observability data is essential to trace the exact mechanism causing the failure.

What's the best way to debug an elusive bug that crosses multiple frameworks and libraries?

The best way to debug cross-layer bugs is a structured forensic workflow that examines source code and observability data end-to-end. It traces failures through application, framework, library, and syscall layers, documenting the investigation to find the smoking gun.

What are the limitations of forensic debugging for software troubleshooting?

Forensic debugging continues until the root cause is found or the visibility limit is proven. If observability data is incomplete or source code access is restricted across system boundaries, the investigation may only prove the visibility limit rather than reveal the exact root cause.