This is a structured checklist workflow that walks you through fixing bugs the right way: reproduce first, find the root cause, implement a minimal fix, verify it works, then add regression tests. It includes templates for documenting reproduction steps, root cause analysis, and PR descriptions, plus code examples showing defensive patterns like null checks before array operations. The six-step process is deliberately rigid because it prevents the common mistakes like fixing symptoms instead of causes or shipping fixes without proof they actually work. If you tend to rush bug fixes or your team struggles with regressions, this gives you a repeatable framework that forces the discipline of proper verification and documentation.

skills.sh installs
482
GitHub stars
79
last updated
Aug 21, 2026

Install

$ npx -y skills add bobmatnyc/claude-mpm-skills --skill bug-fix --agent claude-code

Installs into .claude/skills of the current project.

Files

Bug Fix Verification

Systematic workflow for verifying bug fixes to ensure quality and prevent regressions.

When to Use This Skill

Use this skill when:

  • Fixing a reported bug
  • Creating PR for bug fix
  • Need to document bug fix verification
  • Want to ensure fix doesn't introduce regressions
  • Need structured approach to bug resolution

Why Bug Fix Verification Matters

Problems It Solves

  • ❌ Fixing symptoms instead of root cause
  • ❌ Introducing new bugs while fixing old ones
  • ❌ Incomplete testing of edge cases
  • ❌ No proof that bug is actually fixed
  • ❌ Poor documentation of fix reasoning

Benefits

  • ✅ Confirms bug is truly fixed (not masked)
  • ✅ Documents root cause analysis
  • ✅ Prevents regression with tests
  • ✅ Provides clear evidence for stakeholders
  • ✅ Improves team knowledge of codebase

Bug Fix Workflow

Step 1: Reproduce Before Fix

Critical: Never fix a bug without first reproducing it.

Sponsors

Details

Repository
github.com/bobmatnyc/claude-mpm-skills
Categories
Code Review & Quality, Debugging, Automation & Workflows
First seen
Jun 3, 2026

More from bobmatnyc/claude-mpm-skills

All 158
1manutej avatarapi-gateway-patternsmanutej/luxor-claude-marketplaceComprehensive API gateway patterns skill covering Kong, routing, rate limiting, authentication, load balancing, traffic management, and production gateway archi482skills.sh installs
2gbsoss avatarskill-from-githubgbsoss/skill-from-mastersCreate skills by learning from high-quality GitHub projects479skills.sh installs
3secondsky avatarfrontend-designsecondsky/claude-skillsCreate distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applicat479skills.sh installs
4aj-geddes avatarmutation-testingaj-geddes/useful-ai-promptsEvaluate test suite quality by introducing code mutations and verifying tests catch them. Use for mutation testing, test quality, mutant detection, Stryker, PIT478skills.sh installs
5skindhu avatareducational-video-creatorskindhu/skind-skillsCreate educational videos using Remotion with Kurzgesagt/回形针 style. Use when users want to: (1) create teaching or educational videos, (2) design video storyboa478skills.sh installs
6parcadei avataragentica-serverparcadei/continuous-claude-v3Agentica server + Claude proxy setup - architecture, startup sequence, debugging476skills.sh installs