One-click install
npx skills add https://github.com/eugenelim/agent-ready-repo --skill bug-fix-eugenelim
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bug-fix
Source: https://github.com/eugenelim/agent-ready-repo/tree/main/.agents/skills/bug-fix
Command: npx skills add https://github.com/eugenelim/agent-ready-repo --skill bug-fix-eugenelim

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you fix defects in existing code by forcing a disciplined workflow that starts with reproduction and ends with a minimal, verified root-cause fix.

Core Features & Use Cases

  • Reproduce before repairing: capture a failing test, reliable manual repro, or concrete error evidence before changing code.
  • Root-cause analysis: compare plausible causes, falsify rivals, and identify whether the defect lives in the caller, callee, or a shared assumption.
  • Regression protection: keep the failing test as a lasting safeguard so the same bug cannot return unnoticed.
  • Use Case: A checkout total stops updating after removing an item; use this Skill to reproduce the failure, isolate the broken logic, patch only the defect, and leave a regression test behind.

Quick Start

Use the bug-fix skill to investigate the broken behavior, reproduce the bug, write the failing test, and apply the smallest fix that addresses the root cause.

Frequently Asked Questions about bug-fix

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

FAQPage Schema
How do I fix a bug in a multi-file project without changing unrelated code?

Fix the bug by reproducing the failure, writing a failing test, performing root-cause analysis to falsify rival causes, and applying a minimum-diff repair that leaves a regression test behind.

What is root-cause analysis for debugging broken software behavior?

Root-cause analysis for debugging involves comparing plausible causes, falsifying rivals, and identifying whether the defect lives in the caller, callee, or a shared assumption before repairing code.

How do I reproduce a failing test before repairing a code defect?

Reproduce a failing test by capturing reliable manual reproduction, concrete error evidence, or an automated failing test that triggers the broken behavior before changing any code.

Does bug fixing work for regression testing across multi-file projects?

Yes, bug fixing works for regression testing across multi-file projects by keeping the initially failing test as a lasting safeguard so the same defect cannot return unnoticed.

When do I need a regression test for code repair?

You need a regression test for code repair when a broken behavior is reproduced, ensuring the defect is fixed and preventing the exact same bug from returning unnoticed in the future.