skills.rest
wgordon17
wgordon17COMMUNITY
Explore all skills by this author →
GitHub

bug-investigation

Dispatch background agents to investigate reported bugs and update BUGS.md.

1|Updated Jan 13, 2026
Search Tags:#automation#debugging#investigation#team-collaboration#bug#incident-tracking#bug-management
One-click install
npx skills add https://github.com/wgordon17/personal-claude-marketplace --skill bug-investigation-wgordon17
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bug-investigation
Source: https://github.com/wgordon17/personal-claude-marketplace/tree/main/code-quality/skills/bug-investigation
Command: npx skills add https://github.com/wgordon17/personal-claude-marketplace --skill bug-investigation-wgordon17

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Interactive bug investigation workflow using background agents. Use when the user says "I'm going to report bugs", "let's hunt bugs", "investigate these issues", or describes wanting to report issues one-by-one while agents investigate in parallel. Also activates when the user reports a bug/issue and a BUGS.md file exists or was recently created.

Core Features & Use Cases

  • Dispatch background agents to investigate bugs concurrently.
  • Maintain a centralized BUGS.md to track status, root causes, and resolutions.
  • Coordinate communication and updates without exposing internal traces to the user.

Quick Start

Initiate a bug investigation workflow for a reported issue.

Frequently Asked Questions about bug-investigation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I parallelize bug investigation across multiple reported issues?▼

You can parallelize bug investigation by dispatching background agents to investigate each reported issue concurrently. This multi-agent triage workflow captures root causes and resolutions without exposing internal traces to the user.

What is a BUGS.md file and how does it help track bug status?▼

A BUGS.md file is a centralized tracking document used to record bug status, root causes, and resolutions. The investigation workflow automatically updates this file as background agents complete their analysis.

Can I use background agents to investigate bugs reported one by one in a conversation?▼

Yes, background agents can investigate bugs reported one by one in a conversation. The workflow activates when you indicate you want to report issues, dispatching agents in parallel while you continue reporting.

How do I set up a multi-agent triage workflow for incident tracking?▼

To set up multi-agent triage for incident tracking, initiate a bug investigation workflow using conversational bug reports or an existing BUGS.md file. The system applies activation triggers and structured prompts to coordinate the agents.

Do I need an existing BUGS.md file to start investigating bugs with agents?▼

No, you do not need an existing BUGS.md file to start. The workflow also activates when a user reports a bug and a BUGS.md file was recently created, or through conversational bug reports without prior tracking files.

What are the limitations of using parallel agents for team collaboration during bug management?▼

A limitation of using parallel agents for bug management is that internal investigation traces are hidden from the user. The workflow focuses on coordinating communication and updating the BUGS.md file rather than exposing intermediate debugging steps.

Related Skills

Explore More Software Engineering Skills→
oci-ai-incubationsoci-ai-incubations
3

bug-tracker

Log and track bugs in a centralized BUGS.md file.

Official
Intermediate
zenobi-uszenobi-us
68

sharing-skills

Automate GitHub PR review resolution by fixing comments and failing CI checks.

Official
Intermediate
wilsonfaustinowilsonfaustino
2

init-team

Scaffold multi-agent team infrastructure with SQLite state tracking and project configuration updates.

Community
Advanced
mozilor-technologiesmozilor-technologies

start-feature-fix-agent

Automate root-cause debugging and fix implementation for workflow issues.

Official
Advanced