bug-fix-wt

Create isolated Git worktrees to fix bugs and generate pull requests.

Updated Feb 9, 2026
One-click install
npx skills add https://github.com/ousiass/claude-config --skill bug-fix-wt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bug-fix-wt
Source: https://github.com/ousiass/claude-config/tree/main/skills/bug-fix-wt
Command: npx skills add https://github.com/ousiass/claude-config --skill bug-fix-wt

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill allows you to investigate and fix bugs in an isolated Git worktree, ensuring your main development environment remains clean and unaffected throughout the process.

Core Features & Use Cases

  • Isolated Environment: Uses git worktree to create a separate directory for bug fixing, preventing interference with your primary codebase.
  • End-to-End Workflow: Guides you from bug report analysis and worktree setup, through investigation, fixing, testing, and finally to creating a Pull Request.
  • Use Case: When a bug is reported, you can use this Skill to create a dedicated space to reproduce the issue, implement a fix, and ensure it doesn't break anything else, all without touching your main development branch.

Quick Start

Use the bug-fix-wt skill to fix bug report number 42.

Frequently Asked Questions about bug-fix-wt

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

FAQPage Schema
How do I fix bugs without affecting my main development branch?

To fix bugs without affecting your main branch, use a Git worktree to create an isolated development directory. This allows you to reproduce issues, modify code, and run regression tests safely without touching your primary codebase.

What is the best way to manage a bug fix from issue report to pull request?

The best way is to use an end-to-end workflow that processes bug reports from GitHub issues or text input, guides you through investigation and code modification, and automates pull request creation upon test completion.

Can I use GitHub issues as input for my bug fixing workflow?

Yes, you can process bug reports directly from GitHub issues or text input. The workflow parses the report to set up an isolated worktree, guiding you through investigation, regression testing, and code modification to resolve the reported problem.

How does a Git worktree help with regression testing during code modification?

A Git worktree provides a sandboxed environment to run regression tests after code modification. It isolates testing from your main branch, ensuring that fixing a bug does not break existing functionality in your primary development environment.

When should I use an isolated worktree for debugging instead of a regular branch?

Use an isolated worktree when you need to ensure main development branches remain unpolluted by bug-fixing activities. It provides a separate directory to safely reproduce issues, implement fixes, and run tests without interfering with your primary codebase.