How do I install the Oma Debug skill?

Run npx skillmds@latest add gracefullight/oma-debug-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Oma Debug safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Oma Debug?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Oma Debug free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Oma Debug?

gracefullight (@gracefullight) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Oma Debug by gracefullight — Agent Skill

Name: Oma Debug
Author: gracefullight

File contents

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

Follow 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

---name: oma-debug-2description: 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.---# 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 Rules1. Reproduce first, then diagnose - never guess at fixes2. Identify root cause, not just symptoms3. Minimal fix: change only what's necessary4. Every fix gets a regression test5. Search for similar patterns elsewhere after fixing6. Document in `.agents/results/bugs/`## How to ExecuteFollow `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`

Frequently asked questions

Oma Debug