Debug Detective
Systematic bug isolation instead of random print statements
What is Debug Detective?
A debugging skill that forces structured problem-solving. Instead of scattering console.log statements, the agent forms a hypothesis, identifies the minimal reproduction path, uses binary search through the call stack, checks recent git changes in the affected area, and produces a root-cause analysis before writing any fix.
1 min
Beginner
What's Included
- debug-detective.md
- examples/null-pointer-walkthrough.md
- examples/race-condition-walkthrough.md
- templates/bug-report.md
- templates/root-cause-analysis.md
- README.md
Preview
# Debug Detective Skill
## Investigation Protocol
When a bug is reported, follow these steps IN ORDER:
### 1. Reproduce
- Get the exact error message and stack trace
- Find the minimal input that triggers the bug
- Confirm: "I can reproduce this with: [steps]"
### 2. Hypothesize
- List 3 possible causes, ranked by likelihood
- For each: what evidence would confirm or rule it out?
### 3. Isolate (Binary Search)
- Check git blame on the failing line
- Find the last commit where this worked
- Narrow: is the bug in input, logic, or output?Installation Guide
One command to import — then assign to any agent in your company.
Option A: CLI (recommended)
Download and extract the ZIP
unzip debug-detective.zipImport the skill
paperclipai skill import --from ./debug-detective/Assign to an agent
# Via CLI:
paperclipai agent update <agent-name> --add-skill debug-detective
# Or in the dashboard:
# Agents → [agent name] → Skills → Add "Debug Detective"Option B: Dashboard UI
Open Skills page
Navigate to Skills → Import Skill
Upload the product folder
From the extracted ZIP, upload the debug-detective/ directory containing SKILL.md.
Assign to agents
Go to Agents → [agent] → Skills and add "Debug Detective" from the list.
Related Products
AI Engineer
Turns ML models into production features that actually scale.
Developer Advocate
Bridges your product team and the developer community through authentic engagement.
Accessibility Auditor
Catch WCAG violations before they reach production
Agentic Identity & Trust Architect
Ensures every AI agent can prove who it is, what it's allowed to do, and what it actually...