skills.rest
fx
fxCOMMUNITY
Explore all skills by this author →
GitHub

fix

Runs a test-first bug-fix lifecycle that reproduces bugs with failing tests before implementing fixes.

Updated Nov 2, 2025
Search Tags:#code review#bug fix#test-driven development#regression testing#sdlc#minimal fix#failing test
One-click install
npx skills add https://github.com/fx/skills --skill fix-fx
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: fix
Source: https://github.com/fx/skills/tree/main/skills/fix
Command: npx skills add https://github.com/fx/skills --skill fix-fx

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Bug fixes often get applied without proof they work, leading to false fixes, regressions, and endless back-and-forth. This Skill enforces a test-first discipline: no fix is implemented until an automated test reproduces the bug and fails for the right reason. ## Core Features & Use Cases - Mandatory Test-First Verification: Requires writing the most concise failing test that reproduces the bug before any implementation begins. - SDLC Integration: Loads the dev skill and follows its full lifecycle (requirements, planning, implementation, PR creation, review, CI) with modified bug-fix steps. - Minimal Fix Scope Contract: Carries a Scope Brief into implementation and review so a bug report authorizes only that fix, not surrounding refactors. - Use Case: A user reports a crash when submitting an empty form. The Skill writes a failing test reproducing the crash, verifies it fails correctly, then implements the minimal fix and confirms all tests pass. ## Quick Start Invoke the fix skill to reproduce this reported bug with a failing test and then implement the minimal fix.

Frequently Asked Questions about fix

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

FAQPage Schema
How do I fix a bug using test-driven development?▼

Write the most concise failing test that reproduces the bug, verify it fails for the expected reason, then implement the minimal fix until the test passes. This Skill automates that sequence by delegating test writing and fixing to a coder skill within the SDLC workflow.

What happens if the bug cannot be reproduced with a test?▼

The Skill instructs the agent to ask the user for more information or investigate the root cause further rather than guessing at a fix. No implementation proceeds without a failing test that reproduces the reported behavior.

Does this skill handle pull requests and CI after the fix?▼

Yes. After the test-first reproduction step, it loads the dev skill and follows the full SDLC lifecycle, which includes PR creation, review, and CI monitoring as mandatory remaining steps.

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

Avoid it when the reported issue actually requires a redesign, migration, or changes to unrelated subsystems. In those cases the Skill stops and reports back to the user instead of delivering a refactor disguised as a bug fix.

How does the skill prevent scope creep during bug fixes?▼

It treats minimal fix as a scope contract, carrying a Scope Brief document into implementation and every reviewer call. Any change beyond the reported bug triggers a stop-and-report to the user with the cheapest option first.

Related Skills

Explore More Software Engineering Skills→
pcasarettopcasaretto

bug-reproduction-validator

Reproduce reported software issues and classify them as bugs, environmental problems, or user errors.

Community
Advanced
0xdeafcafe0xdeafcafe

drive-pr

Resolve trusted GitHub PR feedback, fix CI failures, and update descriptions.

Community
Advanced
fxfx
8

resolve-pr-feedback

Detect unresolved Copilot and CodeRabbit threads on GitHub pull requests and invoke resolver skills.

Community
Advanced
gabergergaberger
4

hex-swarm

Coordinate HexFlo swarms to manage multi-agent development tasks across adapters and lifecycle actions.

Community
Advanced