bowen31337

Bug Report Agent Skills — AI skill for Claude Code

AI community

AI agent skill for automated bug report processing and systematic debugging.

How to install Bug Report Agent Skills

This entry records only its repository, not the path inside it, so there is no exact command to give. Open bowen31337/bug-report-agent-skills and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Bug Report Agent Skills does

AI agent skill for automated bug report processing and systematic debugging. Enforces Detective Methodology workflow: reproduction, investigation, root cause analysis, verification, and regression testing. Supports GitHub Issues, Linear, Bugzilla.

Alternatives in AI

Hexstrike AI — HexStrike AI MCP Agents is an advanced MCP server that lets AI agents (Claude, GPT, Copilot, etc.) autonomousl 8.2k ★
Dive Into Claude Code — A Systematic Analysis and Discussion of Claude Code for Designing Today's and Future AI Agent Systems 2.1k ★
Ring — 89 skills and 38 specialized agents that enforce proven engineering practices for AI-assisted development 176 ★

README

Bug Report Agent Skill

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Python 3.9+](https://img.shields.io/badge/python-3.9+-blue.svg)](https://www.python.org/downloads/) [![Agent Skills](https://img.shields.io/badge/Agent%20Skills-Compatible-brightgreen.svg)](https://agentskills.io)

An AI agent skill for automated bug report processing and systematic debugging through the **Detective Methodology**. Transform bug reports from any ticket system into structured workflows that enforce best practices for reproduction, investigation, root cause analysis, and verification.

🎯 Overview

This skill enables AI agents to:

Parse bug reports from Linear, GitHub Issues, Bugzilla, or custom formats
Extract and analyze stack traces (Python, JavaScript, Java, C#)
OCR screenshots to extract error messages
Track investigation notes, hypotheses, and root cause analysis
Automate reproduction verification with Selenium/Playwright
Enforce systematic workflow through phase-gated progression
Run regression tests before marking bugs as resolved

🚀 Quick Start

Installation

# Clone the repository
git clone https://github.com/YOUR_USERNAME/bug-report-agent-skills.git
cd bug-report-agent-skills

# Install uv (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install dependencies (Python 3.9+)
uv sync

# Or to include development dependencies
uv sync --extra dev

# Install tesseract-ocr (required for screenshot OCR)
# macOS
brew install tesseract

# Ubuntu/Debian
sudo apt-get install tesseract-ocr

Process Your First Bug

# Process a bug report (run from your project directory)
uv run /path/to/bug-report-agent-skills/scripts/process_bug.py path/to/bug-report.md

# Start the detective workflow
uv run /path/to/bug-report-agent-skills/scripts/detective_engine.py --directory ./bugs

**Important Note:** The `.bug-states/` fol