Agent skill

Fix Tests

by NeoLabHQ in NeoLabHQ/context-engineering-kit

Systematically fix all failing tests after business logic changes or refactoring

GPL-3.0Auto-check passedDevelopment

Install Fix Tests

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

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install NeoLabHQ/context-engineering-kit fix-tests --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/NeoLabHQ/context-engineering-kit.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/fix-tests .claude/skills/fix-tests && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
fix-tests
GitHub stars
1.7k
Token cost
~914 tokens
SKILL.md length
417 words
Files
1
Skills in repo
57
Repo updated
First seen
Licence
GPL-3.0

At a glance

Systematically fix all failing tests after business logic changes or refactoring

  • Works in 4 steps: Read sadd skill if available → Discover test infrastructure → Run all tests → …
  • Tasks that involve Failing and flaky tests
  • SKILL.md covers User Arguments, Context, Goal and Important Constraints, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Fix Tests is an agent skill from NeoLabHQ/context-engineering-kit. Systematically fix all failing tests after business logic changes or refactoring

Its SKILL.md is about 910 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Failing and flaky tests and Refactoring. The repository describes itself as: Hand-crafted Claude Code Skills focused on improving agent results quality. Compatible with OpenCode, Cursor, Antigravity, Gemini CLI, and others. Includes CodeRabbit open-source… The licence is GPL-3.0.

When your agent uses it

  • Tasks that involve Failing and flaky tests
  • Tasks that involve Refactoring

Example prompts

  • “/fix-tests”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Read sadd skill if available
  2. Discover test infrastructure
  3. Run all tests
  4. Identify all failing test files

What it can do on your machine

Read from SKILL.md and the folder at commit 23e2428. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Fix Tests loads about 914 tokens when it runs. Until then it costs about 23 tokens; SKILL.md has 417 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~23
When it runs · the whole SKILL.md, loaded when a task matches
~914

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from NeoLabHQ/context-engineering-kit at commit 23e2428, republished under its GPL-3.0 licence (© NeoLabHQ). 417 words, ~914 tokens.

Download SKILL.mdSave it as .claude/skills/fix-tests/SKILL.md (or your agent's skills folder).
name
fix-tests
description
Systematically fix all failing tests after business logic changes or refactoring

Fix Tests

User Arguments

User can provide to focus on specific tests or modules:

$ARGUMENTS

If nothing is provided, focus on all tests.

Context

After business logic changes, refactoring, or dependency updates, tests may fail because they no longer match the current behavior or implementation. This command orchestrates automated fixing of all failing tests using specialized agents.

Goal

Fix all failing tests to match current business logic and implementation.

Important Constraints

  • Focus on fixing tests - avoid changing business logic unless absolutely necessary
  • Preserve test intent - ensure tests still validate the expected behavior
  • "Analyse complexity of changes" -
    • if there 2 or more changed files, or one file with complex logic, then Do not write tests yourself - only orchestrate agents!
    • if there is only one changed file, and it's a simple change, then you can write tests yourself.

Workflow Steps

Preparation
  1. Read sadd skill if available

    • If available, read the sadd skill to understand best practices for managing agents
  2. Discover test infrastructure

    • Read @README.md and package.json (or equivalent project config)
    • Identify commands to run tests and coverage reports
    • Understand project structure and testing conventions
  3. Run all tests

    • Execute full test suite to establish baseline
  4. Identify all failing test files

    • Parse test output to get list of failing test files
    • Group by file for parallel agent execution
Analysis
  1. Verify single test execution
    • Choose any test file
    • Launch haiku agent with instructions to find proper command to run this only test file
      • Ask him to iterate until you can reliably run individual tests
    • After he complete try running a specific test file if it exists
    • This ensures agents can run tests in isolation
Show full SKILL.md (144 more words)Show less
Test Fixing
  1. Launch developer agents (parallel)

    • Launch one agent per failing test file
    • Provide each agent with clear instructions:
      • Context: Why this test needs fixing (business logic changed)
      • Target: Which specific file to fix
      • Guidance: Read TDD skill (if available) for best practices how to write tests.
      • Resources: Read README and relevant documentation
      • Command: How to run this specific test file
      • Goal: Iterate until test passes
      • Constraint: Fix test, not business logic (unless clearly broken)
  2. Verify all fixes

    • After all agents complete, run full test suite again
    • Verify all tests pass
  3. Iterate if needed

    • If any tests still fail: Return to step 5
    • Launch new agents only for remaining failures
    • Continue until 100% pass rate

Success Criteria

  • All tests pass ✅
  • Test coverage maintained
  • Test intent preserved
  • Business logic unchanged (unless bugs found)

Agent Instructions Template

When launching agents, use this template:

The business logic has changed and test file {FILE_PATH} is now failing.

Your task:
1. Read the test file and understand what it's testing
2. Read TDD skill (if available) for best practices on writing tests.
3. Read @README.md for project context
4. Run the test: {TEST_COMMAND}
5. Analyze the failure - is it:
   - Test expectations outdated? → Fix test assertions
   - Test setup broken? → Fix test setup/mocks
   - Business logic bug? → Fix logic (rare case)
6. Fix the test and verify it passes
7. Iterate until test passes

© NeoLabHQ, GPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/fix-tests of NeoLabHQ/context-engineering-kit.

Open the folder on GitHubat commit 23e2428

Compare with similar skills

Fix Tests next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Fix Tests compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Fix Tests this skillNeoLabHQ/context-engineering-kit1.7k—~914Automated safety check: PassGPL-3.0
Build Fixcodewithmukesh/dotnet-claude-kit755—~1.8kAutomated safety check: PassMIT
Test Guidelinesgetsentry/sentry-dart873—~3.1kAutomated safety check: PassMIT
Code SolvingHoangTheQuyen/think-better122—~3.7kAutomated safety check: PassMIT
Adk Reviewgoogle/adk-python22k—~1.6kAutomated safety check: PassApache-2.0
Refactor Valuesidavidov13/agentic-playwright225—~2.3kAutomated safety check: PassMIT

Similar skills

  • Build Fix

    codewithmukesh/dotnet-claude-kit

    Autonomous iteration loops for .NET: drive a broken build or failing test suite to green with bounded iterations, progress detection, and fail-safe guards that prevent infinite retries and wasted…

    755 GitHub stars~1.8k tokensUpdated 2 mo ago
    DevelopmentAuto-check passed
  • Test Guidelines

    getsentry/sentry-dart

    Official

    Enforce Sentry Dart/Flutter SDK test conventions for naming, structure, and fixtures.

    873 GitHub stars~3.1k tokensUpdated today
    Testing & QAAuto-check passed
  • Code Solving

    HoangTheQuyen/think-better

    Structured coding workflow for non-trivial code work: debug, build features, refactor, optimize, migrate and review code through 7 steps with evidence-based quality gates.

    122 GitHub stars~3.7k tokensUpdated today
    Testing & QAAuto-check passed
  • Adk Review

    google/adk-python

    Official

    Reviews the uncommitted changes in an adk-python working tree and reports correctness, design, public-API stability, test, sample and documentation gaps as a prioritized findings report, fixing them…

    22k GitHub stars~1.6k tokensUpdated today
    DevelopmentAuto-check passed
  • Refactor Values

    idavidov13/agentic-playwright

    Safe refactoring workflow for enum values, enum keys, and static test data in test-data/static/.ts — mandatory impact analysis, cascading updates, and verification.

    225 GitHub stars~2.3k tokensUpdated yesterday
    Testing & QAAuto-check passed
  • Codex CLI

    sundial-org/awesome-openclaw-skills

    Use OpenAI Codex CLI for coding tasks. An agent skill from sundial-org/awesome-openclaw-skills.

    663 GitHub stars~2k tokensUpdated 7 mo ago
    DevelopmentAuto-check passed

More from NeoLabHQ/context-engineering-kit

All 57 skills in this repo
  • Git Notes

    NeoLabHQ/context-engineering-kit

    A skill your agent uses when adding metadata to commits without changing history, tracking review status, test results, code quality annotations, or supplementing commit messages post-hoc - provides…

    1.7k GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Load PR Comments

    NeoLabHQ/context-engineering-kit

    A skill your agent uses to load open/unresolved PR review comments then aggregate them as tasks in .specs/comments/.md for parallel agents to fix.

    1.7k GitHub stars~2.1k tokensUpdated 1 mo ago
    Auto-check passed
  • Prompt Engineering

    NeoLabHQ/context-engineering-kit

    A skill your agent uses when you writing commands, hooks, skills for Agent, or prompts for sub agents or any other LLM interaction, including optimizing prompts, improving LLM outputs, or designing…

    1.7k GitHub stars~4.2k tokensUpdated 1 mo ago
    Auto-check passed
  • Multi Agent Patterns

    NeoLabHQ/context-engineering-kit

    Design multi-agent architectures for complex tasks. An agent skill from NeoLabHQ/context-engineering-kit.

    1.7k GitHub starsUsed in 6 repos~6k tokens
    Auto-check passed
  • Review PR

    NeoLabHQ/context-engineering-kit

    Review an existing GitHub pull request and post inline review comments on its diff.

    1.7k GitHub stars~3.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Subagent Driven Development

    NeoLabHQ/context-engineering-kit

    A skill your agent uses when executing implementation plans with independent tasks in the current session or facing 3+ independent issues that can be investigated without shared state or…

    1.7k GitHub stars~2.8k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Fix Tests

What does Fix Tests do?

Systematically fix all failing tests after business logic changes or refactoring. Fix Tests is an agent skill from NeoLabHQ/context-engineering-kit.

When should I use Fix Tests?

Fix Tests fits situations like: tasks that involve Failing and flaky tests; tasks that involve Refactoring.

How do I install Fix Tests in Claude Code?

Run `npx skills add NeoLabHQ/context-engineering-kit --skill fix-tests -a claude-code`. Or copy the skill folder (skills/fix-tests in NeoLabHQ/context-engineering-kit) into .claude/skills/fix-tests in your project. Claude Code loads it when a task matches its description.

How do I install Fix Tests in Codex?

Run `npx skills add NeoLabHQ/context-engineering-kit --skill fix-tests -a codex`. Or copy the skill folder (skills/fix-tests in NeoLabHQ/context-engineering-kit) into .agents/skills/fix-tests in your project. Codex loads it when a task matches its description.

Can I use Fix Tests in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add NeoLabHQ/context-engineering-kit --skill fix-tests -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/fix-tests, .gemini/skills/fix-tests, .github/skills/fix-tests and .opencode/skills/fix-tests in your project.

What does Fix Tests need to run?

SKILL.md names no scripts, command-line tools or credentials: Fix Tests is instructions for the agent only.

Does Fix Tests access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Fix Tests safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Fix Tests use?

Fix Tests is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Fix Tests use?

About 914 tokens (SKILL.md is roughly 3.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Fix Tests?

Skills that share tags, products or a category with Fix Tests: Build Fix (codewithmukesh/dotnet-claude-kit, 755 stars), Test Guidelines (getsentry/sentry-dart, 873 stars), Code Solving (HoangTheQuyen/think-better, 122 stars) and Adk Review (google/adk-python, 22k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Fix Tests?

NeoLabHQ (a GitHub organization) maintains it in NeoLabHQ/context-engineering-kit, which has 1,749 GitHub stars. The repository holds 57 skills in this directory. The repository was last updated on August 26, 2026.

Source: NeoLabHQ/context-engineering-kit on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.