debug-mode
"Debug mode workflows and best practices for troubleshooting bugs, regressions, and performance issues. Use when debugging tricky issues that standard agent interactions struggle with."
Resources
2Install
npx skillscat add basedhardware/omi/debug-mode Install via the SkillsCat registry.
This skill provides structured workflows for debugging complex issues like regressions, performance problems, and race conditions that standard methods can't resolve. It solves the challenge of diagnosing hard-to-reproduce or deeply technical bugs by guiding hypothesis generation, log instrumentation, and targeted fixes. Developers should use it when standard debugging approaches fail or when analyzing intricate system behavior.
Debug Mode Skill
Specialized workflows for Debug Mode: hypothesis generation, log instrumentation, runtime analysis, and targeted fixes.
When to Use
Use this skill when:
- Debugging tricky bugs that are hard to reproduce
- Investigating regressions
- Analyzing performance issues
- Troubleshooting race conditions
- Standard agent interactions aren't working
Debug Mode Workflow
1. Exploration and Hypothesis
Agent will:
- Explore relevant code paths
- Generate hypotheses about root causes
- Identify potential failure points
- Plan instrumentation strategy
2. Instrumentation
Agent adds:
- Log statements at key points
- State tracking (variables, buffers, connections)
- Timing information
- Error condition checks
3. Reproduction
You provide:
- Detailed reproduction steps
- Expected vs actual behavior
- Error messages and stack traces
- Context about when bug occurs
4. Analysis
Agent analyzes:
- Collected logs
- State transitions
- Timing patterns
- Error conditions
5. Fix
Agent makes:
- Targeted fix based on evidence
- Minimal changes to address root cause
- Verification of fix
- Cleanup of instrumentation
Best Practices
- Provide detailed context: More information = better hypotheses
- Reproduce consistently: Follow steps exactly
- Multiple reproductions: For intermittent bugs
- Review fixes: Ensure root cause addressed
- Clean up: Remove instrumentation after fix
Related Resources
- Rule:
.cursor/rules/agent-modes.mdc - Command:
/debug - Agent:
.cursor/skills/debug-mode/agents/debug-specialist.md
Categories
Install
npx skillscat add basedhardware/omi/debug-mode Install via the SkillsCat registry.
Repository Stars
The star count shown is for the parent repository (BasedHardware/omi), not this specific skill.
.cursor/skills/debug-mode