skills.rest
Dawaad
DawaadCOMMUNITY
Explore all skills by this author →
GitHub

bug-fix

Fix bugs through a reproduce-first workflow with failing tests and sub-agent code fixes.

Updated Feb 27, 2026
Search Tags:#workflow#debugging#bug fix#test-driven#sub-agent#regression test#failing test
One-click install
npx skills add https://github.com/Dawaad/skills --skill bug-fix-dawaad
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bug-fix
Source: https://github.com/Dawaad/skills/tree/main/skills/bug-fix
Command: npx skills add https://github.com/Dawaad/skills --skill bug-fix-dawaad

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Fixing bugs without a reproduction test leads to incomplete fixes, regressions, and bugs that silently return. This Skill enforces a disciplined test-first workflow so every fix is proven by a failing test before any source code changes. ## Core Features & Use Cases - Structured Bug Interview: Asks targeted questions one at a time about symptoms, reproduction steps, environment, and consistency to fully understand the bug. - Failing Test as Contract: Detects the project's test framework (Jest, pytest, Go, Rust, etc.), writes a precise failing test that reproduces the bug, and confirms it fails before any fix. - Sub-Agent Fix Execution: Spawns a sub-agent that fixes the source code to make the test pass, never modifies the test, and runs the broader suite to catch regressions. - Use Case: A user reports "CSV export drops unicode characters." The Skill interviews them, writes a failing test asserting unicode preservation, then delegates the fix to a sub-agent that makes the test pass without breaking other tests. ## Quick Start Ask the assistant to fix a bug you are seeing, for example: "The export button throws a 500 error when the filename has spaces — run the bug-fix workflow."

Frequently Asked Questions about bug-fix

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

FAQPage Schema
How do I fix a bug with a test-first workflow?▼

First reproduce the bug by writing a failing test that asserts the expected behavior, then fix the source code until the test passes. This Skill automates that flow: it interviews you, writes the failing test, and spawns a sub-agent to make it pass.

How does the bug-fix skill detect my test framework?▼

It inspects project files: package.json for Jest, Vitest, or Mocha; pytest.ini or pyproject.toml for pytest; go.mod for Go testing; and Cargo.toml for Rust. It also follows the patterns of existing test files.

Can the sub-agent modify the failing test while fixing the bug?▼

No. The test is treated as an immutable contract and the sub-agent is explicitly forbidden from modifying it. If the test itself is wrong, the workflow returns to the user rather than silently changing it.

What happens if the fix breaks other tests?▼

The sub-agent runs the broader test suite after the bug test passes. If other tests break, it fixes the regression without breaking the bug fix test, then summarizes all changes made.

When should I not use a test-first bug fix workflow?▼

Do not use it for feature requests, refactors, or performance improvements that do not stem from incorrect behavior. It is designed specifically for reproducible defects, and handles one bug per invocation.

Related Skills

Explore More Software Engineering Skills→
jonkikyjonkiky

investigate

Trace reported issue symptoms to code paths and verify root cause hypotheses.

Community
Advanced
az9713az9713
2

land-and-deploy

Merge pull requests, deploy code, and verify production health.

Community
Advanced
agentmattersagentmatters
3

laravel-verification

Run environment checks, linting, static analysis, tests, and security scans for Laravel projects.

Official
Advanced
portalshqportalshq
5

debugging-strategies

Diagnose bugs and performance issues using systematic debugging workflows and profiling tools.

Official
Intermediate