bug-fix-learning

Diagnose and fix software bugs with a five-step remediation workflow.

58|5|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/mukiwu/muki-ai-plugins --skill bug-fix-learning
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bug-fix-learning
Source: https://github.com/mukiwu/muki-ai-plugins/tree/main/plugins/shipshape-skills/skills/bug-fix-learning
Command: npx skills add https://github.com/mukiwu/muki-ai-plugins --skill bug-fix-learning

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When a user's report indicates actual behavior diverges from expected behavior, this Skill enforces a structured remediation and learning process so fixes don't remain one-off patches. It prevents silent bug fixes by ensuring root cause analysis, evaluation of whether knowledge should be persisted, and a clear summary is always produced.

Core Features & Use Cases

  • Automatic trigger and classification: Detects bug reports in developer conversations and GitHub issues and distinguishes bugs from feature requests, questions, or docs.
  • Five-step enforced workflow: Repair the issue, perform root cause analysis, evaluate whether the learning belongs in cookbook/memory/workflow, perform the write or recommend alternatives, and output a mandatory assessment summary.
  • Actionable guidance: Recommends whether to add type annotations, lint rules, tests, or a cookbook entry, and lists exact files changed when writing is performed.
  • Use case: Triage a failing QA report or GitHub issue, patch the regression, decide if the cause is an external library pitfall or a hidden timing bug, and record the decision into project documentation or automated checks.

Quick Start

Triage this report as a bug, fix the failure, analyze the root cause, evaluate whether to write a cookbook or update tests/linting, and produce a final summary of actions and file changes.

Frequently Asked Questions about bug-fix-learning

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

FAQPage Schema
How do I turn bug fixes into lasting project knowledge instead of one-off patches?

To turn bug fixes into lasting project knowledge, apply a structured remediation workflow that repairs the issue, performs root cause analysis, evaluates whether the learning belongs in cookbook entries or automated tests, and outputs a mandatory summary of all changes.

What is the best way to triage GitHub issues and distinguish actual bugs from feature requests?

Triaging GitHub issues to distinguish bugs from feature requests involves automatically detecting reports where actual behavior deviates from expected behavior, then applying a structured repair and root cause analysis workflow to remediate the confirmed bug.

How does root cause analysis work after patching a failing QA regression?

Root cause analysis after patching a regression works by evaluating the underlying trigger, such as an external library pitfall or hidden timing bug, then recommending whether to add type annotations, lint rules, or tests to prevent recurrence.

Can I use test-driven development to document bug fixes and prevent silent patches?

Yes, you can use test-driven development to document bug fixes and prevent silent patches by enforcing a mandatory assessment summary that recommends adding tests or cookbook entries alongside the actual code repair.

When do I need to write a cookbook entry versus updating lint rules for a software bug?

You need to write a cookbook entry versus updating lint rules by evaluating the root cause during the knowledge evaluation step, which recommends recording external library pitfalls as cookbook entries and code pattern issues as lint rules.