debug-detective

Diagnose and resolve bugs using a five-step reproduce, isolate, understand, fix, and verify protocol.

Updated Oct 1, 2025
One-click install
npx skills add https://github.com/j0KZ/mcp-agents --skill debug-detective
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug-detective
Source: https://github.com/j0KZ/mcp-agents/tree/main/docs/universal-skills/debug-detective
Command: npx skills add https://github.com/j0KZ/mcp-agents --skill debug-detective

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debugging often feels ad-hoc. This Skill provides a universal, repeatable protocol to locate and fix bugs across languages and frameworks.

Core Features & Use Cases

  • Reproduce → Isolate → Understand → Fix → Verify protocol
  • Language-agnostic debugging steps and quick checks
  • Practical tips and techniques for root-cause analysis

Quick Start

Execute the universal 5-step debug protocol on your project to resolve issues quickly.

Frequently Asked Questions about debug-detective

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

FAQPage Schema
How do I systematically debug crashes and errors in my codebase?

Systematically debug by following a five-step protocol: reproduce the bug consistently, isolate it to specific code or conditions, understand the root cause through analysis, apply a minimal fix, then verify the fix resolves the issue without side effects. This universal approach works across all languages and frameworks.

Can I use a debugging protocol that works with any programming language?

Yes. The universal debugging protocol applies to all codebases regardless of language or framework. It guides you through reproducibility, isolation, understanding, fixing, and verification—complemented by language-agnostic logging and tracing strategies.

How do I diagnose intermittent bugs and environment-specific failures?

Isolate intermittent and environment-specific failures by reproducing them consistently, then systematically narrow down the conditions triggering the issue. Use logging and tracing to capture state across different environments, then apply targeted fixes verified in each context.

What's the best approach for diagnosing performance issues in production?

Diagnose performance issues by reproducing the degradation, isolating the affected code paths through tracing and logging, understanding the bottleneck's root cause, fixing the inefficiency with minimal changes, then verifying improvement under real-world load.

Do I need special tools to debug across different projects and frameworks?

No. The universal debugging protocol works without framework-specific tools. It provides language-agnostic steps, logging techniques, and analysis methods that apply to any codebase, though optional MCP-enabled analysis methods can enhance the workflow.