mutation-test-runner

Generate code mutants and evaluate test detection with PASS/NEEDS_REVISION/BLOCKED verdicts.

1|Updated Apr 12, 2026
One-click install
npx skills add https://github.com/mytechsonamy/VibeFlow --skill mutation-test-runner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mutation-test-runner
Source: https://github.com/mytechsonamy/VibeFlow/tree/main/skills/mutation-test-runner
Command: npx skills add https://github.com/mytechsonamy/VibeFlow --skill mutation-test-runner

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Mutation-test-runner helps you identify weaknesses in test suites by generating code mutations and computing a mutation score, ensuring you catch real regressions.

Core Features & Use Cases

  • Generates code mutations from a catalog and runs the test suite to measure detectability.
  • Enforces P0 zero-survivor gate and domain-specific mutation thresholds for release decisions.
  • Provides reports and weak-assertions guidance to improve tests.

Quick Start

Run the mutation-test-runner on your repository to begin the first mutation wave.

Frequently Asked Questions about mutation-test-runner

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

FAQPage Schema
What is mutation testing and how does it expose gaps in software testing?

Mutation testing exposes test gaps by generating code mutants from a catalog and evaluating whether your existing tests detect them. It computes a mutation score to measure test suite detectability and identify weaknesses, ensuring you catch real regressions before release.

How do I enforce zero surviving mutants in P0 paths during a PR gate?

To enforce zero surviving mutants in PR gates, apply mutation testing to evaluate generated code mutants against your test suite. The runner outputs a PASS, NEEDS REVISION, or BLOCKED verdict based on your domain-specific score thresholds and P0 zero-survivor gate requirements.

Do I need a configured mutation runner and domain config to measure mutation scores?

Yes, measuring mutation scores requires a domain config, source and test files, and a configured mutation runner. You must also provide domain-specific score thresholds to evaluate mutant detectability and produce a final release decision verdict.

Can mutation testing identify weak assertions in my test coverage?

Yes, mutation testing identifies weak assertions by generating code mutants that your tests should catch. If mutants survive, the runner provides weak-assertions guidance and reports to help you improve test coverage and strengthen your suite's bug detection capabilities.

What is the best way to use mutation testing for pre-release quality assurance?

The best way to use mutation testing for pre-release runs is to execute the runner against your repository to begin the first mutation wave. It enforces domain-specific mutation thresholds and P0 zero-survivor gates to ensure proper release engineering quality assurance decisions.

When should I not rely solely on test coverage for bug detection?

You should not rely solely on test coverage for bug detection when high-stakes release engineering is involved. Coverage does not measure assertion quality, whereas mutation testing verifies that your tests actually fail when code mutants are introduced, providing deeper quality assurance.