fix-bug

Reproduce bugs by enhancing tests, then apply minimal fixes and validate via CI.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/datamonsterr/mycoai_projects --skill fix-bug-datamonsterr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fix-bug
Source: https://github.com/datamonsterr/mycoai_projects/tree/main/.agents/skills/fix-bug
Command: npx skills add https://github.com/datamonsterr/mycoai_projects --skill fix-bug-datamonsterr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a disciplined workflow to reproduce, diagnose, and fix bugs by iteratively enhancing tests, implementing a minimal fix, and validating changes with tests and repository checks.

Core Features & Use Cases

  • Reproduce the bug by clarifying expected vs actual behavior and isolating the smallest failing scope.
  • Extend existing tests selectively to create a reliable reproduction and guard against regressions.
  • Gather lightweight debugging evidence (logs, traces, screenshots) to explain failure modes.
  • Implement minimal, cohesive code changes that fix the root cause while preserving or improving tests.
  • Validate the fix by running the enhanced test suite and any repository checks, and prepare a concise summary of root cause and resolution.
  • Integrate with the repository's PR workflow (open-pr or update-pr).

Quick Start

Run the fix-bug skill to reproduce the bug with the minimal failing test, implement a targeted fix, and verify tests pass.

Frequently Asked Questions about fix-bug

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

FAQPage Schema
How do I reproduce a bug with existing tests before applying a fix?

To reproduce a bug, you enhance existing tests iteratively until the smallest failing scope is isolated. This creates a reliable reproduction that clarifies expected versus actual behavior and guards against future regressions before you implement the actual code fix.

What is the best way to debug code and gather evidence for a reported bug?

The best way to debug code is to follow a structured process that gathers lightweight debugging evidence like logs, traces, and screenshots. This evidence explains the failure mode and directly informs a targeted, minimal fix to resolve the root cause.

How do I implement a minimal fix for a bug without breaking existing tests?

You implement a minimal fix by applying cohesive code changes that target the root cause identified during reproduction. Afterward, you validate the fix by running the enhanced test suite and any repository checks to ensure existing tests pass.

Can I integrate bug fixes directly into my CI and pull request workflow?

Yes, you can integrate bug fixes into your CI and pull request workflow. After validating tests and running repository checks, the process summarizes the root cause and resolution, and pushes the changes via an open-pr or update-pr workflow.

Do I need existing tests to use a structured debugging workflow?

Yes, a structured debugging workflow requires software projects with existing tests. It relies on selectively extending those tests to create a reliable reproduction and validate the minimal fix, ensuring stepwise debugging and regression protection.