# Fix Tests

> Use when tests are failing and need systematic fixing until all pass. Triggers on "fix tests", "tests failing", "make tests pass".

- Skill: `tomevault-io/fix-tests` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/fix-tests`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/fix-tests/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/fix-tests

---


# Fix Failing Tests

Use this when you have failing test output. The goal is to **fix ALL failing tests, re-run tests, and iterate until everything passes**.

## Usage

```
/fix-tests
```

Use this after you've pasted test failure output into the conversation.

## What It Does

1. **Understands ALL Failures**
   - Reads entire test log (pytest / Jest / parallel tests)
   - Checks "Test Results" summary for ALL failing tests (looks for `✗` or `FAILED` markers)
   - Checks "Failed Test Details" for MULTIPLE failing test groups
   - Notes ALL test groups that failed (backend, frontend, linting, etc.)
   - Creates list of all failures before starting fixes

2. **Fixes EACH Failure**
   - For EACH failing service/group:
     - Opens failing test files and implementation files
     - Makes smallest, clearest change
     - Prefers fixing implementation over changing tests
   - Fixes ALL failures before proceeding

3. **Re-runs Tests for EACH Fix**
   - Backend: `pytest` (or with `-k` for specific tests)
   - Frontend: `npm run lint` or `npm run test`
   - Verifies each group passes before moving to next
   - Repeats if tests still fail

4. **Re-runs Full Test Suite**
   - **CRITICAL**: Always re-runs original command used to run tests
   - Catches hidden failures or new failures from fixes
   - Only stops when full suite passes with zero failures

## Important Notes

- Don't stop after fixing one failure - check for multiple failing groups
- Always re-run full test suite after fixes
- Parse entire error output - summary AND detailed sections

## Testing Commands

**Backend (pytest):**
```bash
pytest                              # All unit tests
pytest -k "pattern"                 # Specific tests
pytest tests/integration/           # Integration tests
```

**Frontend:**
```bash
npm run lint
npm run test
```

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