bug-fix

Automates the full bug-fix lifecycle from triage to RCA across GitHub issues.

Updated Jan 28, 2026
One-click install
npx skills add https://github.com/wellmadetech/project-template --skill bug-fix-wellmadetech
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bug-fix
Source: https://github.com/wellmadetech/project-template/tree/main/.claude/skills/bug-fix
Command: npx skills add https://github.com/wellmadetech/project-template --skill bug-fix-wellmadetech

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the end-to-end bug lifecycle, enabling teams to rapidly triage, reproduce, investigate, plan, fix, verify, and document root-cause analysis (RCA) for software issues.

Core Features & Use Cases

  • Triage & Prioritization: Quickly classify severity and affected components from issue details.
  • Reproduction & Investigation: Automate environment setup, reproduce steps, capture diagnostics and logs.
  • Planning & Verification: Generate implementation plans, create worktrees/PRs, and verify fixes with RCA documentation.
  • Use Case: When a bug is reported, run the skill to move from triage to a verifiable fix plan and PR with an embedded RCA, reducing cycle time.

Quick Start

Run the bug-fix skill against a GitHub issue number to execute the full lifecycle from triage to RCA. Example: /bug-fix 278

Frequently Asked Questions about bug-fix

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

FAQPage Schema
How do I automate GitHub issue triage and bug reproduction?

Automate GitHub issue triage and bug reproduction by running the bug-fix skill against an issue number to classify severity, reproduce steps, and capture diagnostics. It moves from triage to a verifiable fix plan and PR with an embedded RCA.

What is the best way to automate root-cause analysis for software bugs?

Automate root-cause analysis for software bugs by running an end-to-end lifecycle workflow that investigates issues and embeds RCA documentation directly into the generated PR, ensuring deterministic and auditable fixes.

Can I generate a PR workflow directly from a bug report?

Yes, you can generate a PR workflow directly from a bug report by executing the bug-fix skill against a GitHub issue number. It plans the implementation, creates worktrees and PRs, and verifies the fix automatically.

Does the bug-fix skill require external dependencies to set up environments?

No, the bug-fix skill requires zero external dependencies to set up environments and reproduce steps. It relies on structured state management and comprehensive observability to capture logs and diagnostics natively.

How does automated issue triage classify severity and affected components?

Automated issue triage classifies severity and affected components by parsing issue details and structuring the state management. This deterministic process enables rapid prioritization before reproduction and investigation begin.