# Specswarm Fix

> Handles auto-retry logic when fix verification fails

- Skill: `tomevault-io/specswarm-fix` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/specswarm-fix`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/specswarm-fix/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/specswarm-fix

---


# SpecSwarm Fix Workflow

Provides natural language access to `/specswarm:fix` command.

## Dynamic Context

Recent changes (potential bug source):
`!git log --oneline -5 2>/dev/null || echo "Not a git repository"`

## When to Invoke

Trigger this skill when the user describes ANY software problem:
- Things not working or broken
- Errors, bugs, or failures
- Features not loading or functioning
- Requests to fix, debug, or resolve issues
- ANY report of unexpected behavior

**Examples:**
- "Please fix that the images don't load"
- "Images don't load"
- "Fix the login bug"
- "The checkout is broken"
- "There's an error when submitting forms"
- "Authentication doesn't work"
- "Payment processing fails"
- "The search isn't working"

## Instructions

**Skill-Based Routing:**

1. **Detect** that user described a software problem
2. **Extract** the problem description from their message
3. **Route based on intent clarity**:

   **Clear intent** - Execute directly:
   - Clear bug descriptions: "fix the login bug", "images don't load", "checkout is broken"
   - Action: Immediately run `/specswarm:fix "problem description"`

   **Ambiguous intent** - Ask for confirmation:
   - Less specific: "something's wrong with authentication", "the app isn't working right"
   - Action: Use AskUserQuestion tool with two options:
     - Option 1 (label: "Run /specswarm:fix"): Use SpecSwarm's systematic bugfix workflow
     - Option 2 (label: "Process normally"): Handle as regular Claude Code request

4. **If user selects Option 2**, process normally without SpecSwarm
5. **After command completes**, STOP - do not continue with ship/merge

## What the Fix Command Does

`/specswarm:fix` runs complete workflow:
- Creates regression tests to reproduce bug
- Implements the fix
- Verifies fix works
- Re-runs tests to catch new failures
- Auto-retries up to 2 times if needed

Stops after bug is fixed - does NOT merge/ship/deploy.

## Semantic Understanding

This skill should trigger not just on exact keywords, but semantic equivalents:

**Fix equivalents**: fix, repair, resolve, debug, correct, address, handle, patch
**Broken equivalents**: broken, not working, doesn't work, not showing, not appearing, not displaying, not rendering, not loading, failing, crashed
**Issue terms**: bug, error, problem, issue, trouble, failure

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/martybonacci) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->