mutant

Run mutation testing for Ruby projects with RSpec or Minitest.

2.2k|160|Updated Jul 23, 2012
One-click install
npx skills add https://github.com/mbj/mutant --skill mutant
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mutant
Source: https://github.com/mbj/mutant/tree/main
Command: npx skills add https://github.com/mbj/mutant --skill mutant

SYSTEM DOCUMENTATION & REQUIREMENTS

## What problem does it solve? Mutant provides a structured approach to mutation testing for Ruby projects, surfacing untested behaviors and helping teams verify coverage.

## Core Features & Use Cases

  • Run mutation tests across a codebase and produce per-subject mutation coverage and alive counts.
  • Read alive mutations to decide whether to add tests or simplify code.
  • Integrate with RSpec or Minitest workflows to improve test quality and confidence.

### Quick Start Bundle install and run mutant against your Ruby project to start mutation testing.

Frequently Asked Questions about mutant

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

FAQPage Schema
What does mutation testing do for a Ruby project?

Mutation testing for Ruby introduces small code changes (mutations) and runs your test suite to verify each is caught. It surfaces alive mutations—untested behaviors—so you can add tests or simplify code.

How do I run mutation tests with RSpec or Minitest?

Run mutation tests against your Ruby project using RSpec or Minitest by executing the mutant CLI after bundle install. It generates per-subject mutation coverage and alive mutation counts to guide test improvements.

What are alive mutations and how do I fix them?

Alive mutations are code changes that survive because your test suite fails to detect them. Fix alive mutations by adding tests to cover the untested behavior or by simplifying the code to remove unnecessary branches.

Can I use mutation testing with my existing RSpec and Minitest workflows?

Yes, mutation testing integrates directly with existing RSpec or Minitest workflows. It runs within your current Ruby testing setup to evaluate test quality and verify coverage without changing your test framework.

Why should I run mutation testing instead of just checking code coverage?

Mutation testing goes beyond line coverage by actively verifying that tests detect code changes. It exposes alive mutations that traditional coverage metrics miss, helping you decide whether to add tests or simplify code.