Skip to main content
skill CX Codex

fix-tests — Claude Code skill: what it does, how to install

This skill tracks down failing tests after logic changes or refactoring and guides fixes until the suite passes.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add NeoLabHQ/context-engineering-kit --skill fix-tests -a claude-code
Open on GitHub

What fix-tests does

The skill reads README.md and the project configuration, finds test and coverage commands, then runs the full suite. It parses the failures, groups them by file, and checks how to run one test file in isolation. Developer agents then inspect each failing file, the project documentation, and the failure cause before making a fix.

Its main rule is to change tests while preserving what they are meant to verify. Assertions, setup, or mocks may be updated; business logic should change only when it is clearly broken. With two or more changed files, or with complex logic in one file, the skill orchestrates agents instead of writing tests itself. A single simple file change can be handled directly. After each pass, it runs the full suite again and returns to the remaining failures. That makes the business-logic boundary worth checking before you accept a fix.

What it helps with

  • locate every failing test file
  • find a reliable command for one test file
  • update assertions after a refactor
  • repair broken test setup or mocks
  • rerun the full suite after fixes

Example prompts for the agent

  • Use fix-tests to find and repair every failing test after a business logic change.
  • Run fix-tests for the tests in src/orders, verify the single-file command, then run the full suite.
  • Apply fix-tests after a dependency update; preserve test intent and change business logic only if it is clearly broken.

How to install fix-tests

1Skills CLI (Vercel)

npx skills add NeoLabHQ/context-engineering-kit --skill fix-tests -a claude-code

2Manually: put the files in place

~/.claude/skills/fix-tests/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/fix-tests/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about fix-tests

How do I install fix-tests in Claude Code?

Run npx skills add NeoLabHQ/context-engineering-kit --skill fix-tests -a claude-code, then run npx skills add NeoLabHQ/context-engineering-kit --skill fix-tests -a claude-code again. The skill file is at ~/.claude/skills/fix-tests/SKILL.md.

What does fix-tests do?

It runs the full test suite, groups failing files, and assigns fixes to developer agents. It then reruns the suite and works through any failures that remain.

Does fix-tests change business logic?

It focuses on fixing tests while preserving their intent. Business logic changes are reserved for clear bugs, and complex changes are handled through agent orchestration.

Similar skills

All skills for Testing and QA →

From the same set64

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor