Agent skill

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.

View SKILL.md on GitHub Repository
Stars 610
Forks 71

Install this agent skill to your Project

npx add-skill https://github.com/first-fluke/oh-my-agent/tree/main/.agents/skills/oma-debug

SKILL.md

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

  1. Reproduce first, then diagnose - never guess at fixes
  2. Identify root cause, not just symptoms
  3. Minimal fix: change only what's necessary
  4. Every fix gets a regression test
  5. Search for similar patterns elsewhere after fixing
  6. 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

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

first-fluke/oh-my-agent

oma-mobile

Mobile specialist for Flutter, React Native, and cross-platform mobile development. Use for mobile app, Flutter, Dart, iOS, Android, Riverpod, and widget work.

610 71
Explore
first-fluke/oh-my-agent

oma-frontend

Frontend specialist for React, Next.js, TypeScript with FSD-lite architecture, shadcn/ui, and design system alignment. Use for UI, component, page, layout, CSS, Tailwind, and shadcn work.

610 71
Explore
first-fluke/oh-my-agent

oma-backend

Backend specialist for APIs, databases, authentication with clean architecture (Repository/Service/Router pattern). Use for API, endpoint, REST, database, server, migration, and auth work.

610 71
Explore
first-fluke/oh-my-agent

oma-pdf

Convert PDF files to Markdown using opendataloader-pdf. Extracts text, tables, headings, lists, and images with correct reading order. Use for PDF parsing, PDF to Markdown conversion, document extraction, and AI-ready data preparation.

610 71
Explore
first-fluke/oh-my-agent

oma-brainstorm

Design-first ideation that explores user intent, constraints, and approaches before any planning or implementation. Use for brainstorming, ideation, exploring concepts, and evaluating approaches.

610 71
Explore
first-fluke/oh-my-agent

oma-scm

SCM (software configuration management) and Git — branching, merges, conflicts, worktrees, baselines, audit readiness, plus Conventional Commits and safe staging.

610 71
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results