debug-and-fix

What problem does it solve?

Pinpoints, isolates, and resolves software bugs by following a disciplined reproduce → root-cause → minimal-fix → verify cycle so fixes are small, auditable, and validated by tests before being merged.

Core Features & Use Cases

• Structured Triage: Parse user reports, error logs, or Linear issues and extract expected vs actual behavior and reproduction steps.
• Reproduce & Locate: Search the codebase, read source and tests, and map stack traces back to source to identify root causes.
• Minimal Fixes & Verification: Apply the smallest diff that resolves the issue, follow project conventions, run the test suite and build, and propose tests when gaps exist.
• Integration: Optionally comment on Linear issues with summaries and proposed status changes after user confirmation.
• Use Case: A user reports a failing login flow; the skill reproduces the error locally, identifies a missing input validation, applies a one-line guard, runs tests, and reports results back to the issue.

Quick Start

Use the debug-and-fix skill to reproduce a failing test, identify the root cause, apply the smallest corrective change, and verify the fix with the project's test suite.