Skills
.Work. You
Rest

mp-bug-report

Community

Turn bug reports into TDD-backed issues.

Software Engineering#root cause analysis#bug report#github issues#codebase investigation#labeling#issue automation#tdd planning
AuthorMartinoPolo
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill helps investigate a reported bug, identify the root cause, and turn the findings into a durable GitHub issue with a vertical-slice TDD fix plan.

Core Features & Use Cases

  • Root-cause investigation: Extracts actual vs expected behavior and reproduction steps, then runs an issue analysis sub-agent to locate the manifestation, trace the code path, and determine the true cause.
  • TDD fix planning: Converts analysis into ordered RED-GREEN vertical slices (then REFACTOR), with tests written against public behavior contracts to stay resilient to refactors.
  • Issue creation with proper labeling: Ensures a bug label exists and creates a GitHub issue titled bug: ... that stays free of brittle details like file paths and line numbers.
  • Multi-bug support: Accepts multiple bug descriptions, splits them into separate investigations, and outputs all created issue URLs with one-line root-cause summaries.

Quick Start

Ask the AI to create bug issues by running mp-bug-report with your bug description(s) inline.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: mp-bug-report
Download link: https://github.com/MartinoPolo/mpx-claude-code/archive/main.zip#mp-bug-report

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.