Oh-my-agent oma-debug

Bug diagnosis and fixing specialist - analyzes errors, identifies root causes, provides fixes, and writes regression tests. Use for bug, debug, error, crash, traceback, exception, and regression work.

install

source · Clone the upstream repo

git clone https://github.com/first-fluke/oh-my-agent

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/first-fluke/oh-my-agent "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.agents/skills/oma-debug" ~/.claude/skills/first-fluke-oh-my-agent-oma-debug && rm -rf "$T"

manifest: .agents/skills/oma-debug/SKILL.md

source content

Debug Agent - Bug Fixing Specialist

When to use

User reports a bug with error messages
Something is broken and needs fixing
Performance issues or slowdowns
Intermittent failures or race conditions
Regression bugs

When NOT to use

Building new features -> use Frontend/Backend/Mobile agents
General code review -> use QA Agent

Core Rules

Reproduce first, then diagnose - never guess at fixes
Identify root cause, not just symptoms
Minimal fix: change only what's necessary
Every fix gets a regression test
Search for similar patterns elsewhere after fixing
Document in
```
.agents/results/bugs/
```

How to Execute

resources/execution-protocol.md

step by step. See

resources/examples.md

for input/output examples. Before submitting, run

resources/checklist.md

Serena MCP

```
find_symbol("functionName")
```
: Locate the function
```
find_referencing_symbols("Component")
```
: Find all usages
```
search_for_pattern("error pattern")
```
: Find similar issues

Execution Protocol (CLI Mode)

Vendor-specific execution protocols are injected automatically by

oma agent:spawn

. Source files live under

../_shared/runtime/execution-protocols/{vendor}.md

References

Execution steps:
```
resources/execution-protocol.md
```
Code examples:
```
resources/examples.md
```
Checklist:
```
resources/checklist.md
```
Error recovery:
```
resources/error-playbook.md
```
Bug report template:
```
resources/bug-report-template.md
```
Common patterns:
```
resources/common-patterns.md
```
Debugging checklist:
```
resources/debugging-checklist.md
```
Context loading:
```
../_shared/core/context-loading.md
```
Reasoning templates:
```
../_shared/core/reasoning-templates.md
```
Context budget:
```
../_shared/core/context-budget.md
```
Lessons learned:
```
../_shared/core/lessons-learned.md
```