fix-bug

Automate bug fixing with a test-driven development workflow.

213|13|Updated Aug 7, 2025
One-click install
npx skills add https://github.com/imbue-ai/sculptor --skill fix-bug-imbue-ai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fix-bug
Source: https://github.com/imbue-ai/sculptor/tree/main/sculptor/sculptor-workflow/skills/fix-bug
Command: npx skills add https://github.com/imbue-ai/sculptor --skill fix-bug-imbue-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill automates the process of fixing bugs using a test-driven development (TDD) workflow, saving time and reducing the likelihood of introducing new bugs.

Core Features & Use Cases

  • Test-Driven Development: Enforces a TDD workflow where you write a failing test before writing the code to fix the bug.
  • Interactive and Autonomous Modes: Supports both interactive and autonomous modes for bug fixing.
  • Config File Integration: Integrates with config files for codebase structure, test strategy, and bug tracking.
  • Branch Creation and Management: Creates a new branch for each bug fix and manages the commit process.
  • Bug Ticket Handling: Handles bug tickets by fetching context and classifying outcomes.
  • Verification: Provides visual verification and self-review passes for code changes.

Quick Start

Use the /sculptor-workflow:fix-bug skill to automatically fix a bug in your codebase by providing a description of the bug or a bug ticket ID.

Frequently Asked Questions about fix-bug

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

FAQPage Schema
How do I automate bug fixing using test-driven development?

Automating bug fixing with test-driven development requires a workflow that writes a failing test before the fix, creates a branch, and verifies the code changes. This Skill enforces that TDD workflow and manages the commit process to resolve defects.

What is the best way to handle bug tickets and codebase structure for automated fixes?

Handling bug tickets and codebase structure for automated fixes involves integrating config files for testing strategy and bug tracking. This workflow fetches bug context, classifies outcomes, and uses config files to navigate your specific codebase structure.

Can I use an autonomous mode for test-driven development bug fixes?

You can use autonomous mode for test-driven development bug fixes alongside an interactive mode. Both modes support identifying and resolving software defects automatically while enforcing the creation of failing tests before applying the code fix.

Do I need config files to automate software defect resolution?

You need config files to automate software defect resolution because they define the codebase structure and testing strategy. These config files integrate with branch management and code review tools to ensure visual verification and self-review passes.

How does branch creation work when fixing bugs with TDD?

Branch creation when fixing bugs with TDD isolates changes by creating a new branch for each defect. The workflow manages the commit process and handles bug tickets by fetching context, classifying outcomes, and verifying code changes before review.