Mutation Tester
Validates test suite quality by running mutation testing tools (Stryker, mutmut, PITest) and analyzing survived mutants to identify under-tested logic paths — outputting kill rates and targeted recommendations for filling gaps. Use when code coverage looks healthy but test confidence is still low. Trigger with \"run mutation tests\", \"find test gaps with mutation testing\".
- Type
- Subagent
- Repository
- jeremylongshore/tons-of-skills-marketplace
- GitHub stars
- 2.8k
- License
- MIT
- Repo last updated
- Sep 27, 2026
- Model
- sonnet
- Version
- 1.0.0
- Author
- Jeremy Longshore <[email protected]>
What Mutation Tester is
Mutation Tester is a subagent published in the jeremylongshore/tons-of-skills-marketplace repository on GitHub, which has about 2.8k stars. The repository describes itself as: “Model-agnostic agent-skills platform with a harness-free canonical layer, verified adapters, and the ccpi package manager. Explore at tonsofskills.com.”
A subagent is a specialist assistant that Claude can hand part of a task to. It is a markdown file whose frontmatter sets a name, a description that tells Claude when to delegate, and optionally the tools and model it may use; the body becomes the subagent's own system prompt.
Because a subagent works in its own context, it keeps the main conversation focused: Claude can send a narrow job, such as a review or a specialised analysis, to Mutation Tester and get back a compact result.
How to install Mutation Tester
Claude Code
- Download mutation-tester.md from the repository.
- Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control.
- Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.
Claude Cowork
- Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent.
- Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.
New to extending Cowork? Our plugins guide and Customize guide explain how skills, plugins, and connectors fit together.
Inside the source file
An excerpt from plugins/testing/mutation-test-runner/agents/mutation-tester.md, shared under the repository's MIT license. Read the full file on GitHub.
Validate test suite quality by introducing code mutations and verifying tests catch them.
Mutation Testing Concept
Mutation testing modifies ("mutates") code to check if tests detect the changes:
- Mutant killed - Test failed (good, caught the bug)
- Mutant survived - Test passed (bad, missed the bug)
Common Mutations
- Arithmetic Operators - + to -, * to /
- Comparison Operators - > to >=, == to !=
- Logical Operators - && to ||, ! removal
- Boolean Literals - true to false
- Return Values - Change return values
- Conditionals - Remove if statements
- Increments - ++ to --
Example
// Original code
function isPositive(num) {
return num > 0;
}
// Mutation 1: Change > to >=
function isPositive(num) {
return num >= 0; // Should fail test for isPositive(0)
}
// Mutation 2: Change > to <
function isPositive(num) {
return num < 0; // Should fail all tests
}Mutation Testing Tools
- JavaScript: Stryker Mutator
- Python: mutmut, cosmic-ray
- Java: PITest
- C#: Stryker.NET
- Ruby: Mutant
Report Format
Mutation Testing Report
=======================
Total Mutants: 150
Killed: 142 (94.7%)
Survived: 8 (5.3%)
Timeout: 0
No Coverage: 0
Mutation Score: 94.7%
Survived Mutants:
src/utils/validator.js:23
- Replaced > with >=
- Suggests missing boundary test
src/api/users.js:45
- Replaced && with ||
- Suggests missing logic test
…Best Practices
- Run after achieving high code coverage
- Focus on survived mutants
- Add tests to kill survivors
- Aim for 80%+ mutation score
- Expensive operation - run periodically
Before you install
- Read the whole file first. Skills, commands, and subagents are instructions Claude will follow, so make sure they match what you want.
- Check which tools, scripts, or MCP servers it uses. Local servers and scripts run with your permissions.
- Try it in a test project or a copy of your files before pointing it at real work.
- Pin the version you tested, and review changes before updating.
- Watch for instructions that fetch web content or run shell commands; those are where prompt injection risks start. See our prompt injection guide.
FAQ
What is Mutation Tester?
Mutation Tester is a subagent for Claude Code and Claude Cowork from the jeremylongshore/tons-of-skills-marketplace repository on GitHub. Validates test suite quality by running mutation testing tools (Stryker, mutmut, PITest) and analyzing survived mutants to identify under-tested logic paths — outputting kill rates and targeted recommendations for filling gaps. Use when code coverage looks healthy but test confidence is still low. Trigger with \"run mutation tests\", \"find test gaps with mutation testing\".
How do I install Mutation Tester in Claude Code?
Download mutation-tester.md from the repository. Save it to ~/.claude/agents/ to use it in every project, or to .claude/agents/ inside one project to share it through version control. Claude Code watches these folders, so the subagent is usually available right away. Ask Claude to use it by name, or @-mention it to make sure it runs.
Can I use Mutation Tester in Claude Cowork?
Cowork loads subagents through plugins. If the repository is packaged as a plugin marketplace, add it under Customize → Plugins → Add marketplace and install the plugin that contains this subagent. Otherwise, bundle the file into your own plugin's agents/ folder and upload it from Customize → Plugins.
Is Mutation Tester safe to install?
It is a third-party community resource, not reviewed by Anthropic or this site. Read the source file first, check which tools and connectors it uses, and install only from sources you trust.
Similar resources
- Over 50s Health Evidence-based health, fitness, nutrition, and longevity guidance for adults 50+ Plugin · jeremylongshore/tons-of-skills-marketplace
- Overnight Dev Run Claude autonomously for 6-8 hours overnight using Git hooks that enforce TDD - wake up to fully tested features Plugin · jeremylongshore/tons-of-skills-marketplace
- Overnight Dev Coach Autonomous overnight development coach that enforces TDD, runs Git hook–gated sessions, debugs failing tests iteratively, and delivers a morning handoff report when all tests are green. Use when you want to run an unattended overnight coding session or set up TDD workflows. Trigger with \"overnight session\", \"autonomous TDD run\". Subagent · jeremylongshore/tons-of-skills-marketplace
- Overnight Setup Setup overnight development with Git hooks for autonomous TDD sessions Slash Command · jeremylongshore/tons-of-skills-marketplace
- N8n Expert Design n8n automation workflows with node configs, JavaScript code nodes, error handling, and full importable JSON exports. Use when building complex automations or self-hosted integrations. Trigger with "design an n8n workflow", "build an n8n automation". Subagent · jeremylongshore/tons-of-skills-marketplace
- Multi Agent Orchestrator Coordinates multi-agent systems by decomposing tasks, routing to the right specialist, managing handoffs with full context, and aggregating outputs into a cohesive result. Use when a complex request spans multiple domains and needs intelligent agent routing. Trigger with \"orchestrate this task\", \"route to the right agent\". Subagent · jeremylongshore/tons-of-skills-marketplace
- Nextjs Dev Implements Next.js 16 frontend features (App Router, Server/Client Components, TypeScript, TailwindCSS v4, i18n) strictly from sprint API contract and frontend specs, returning a structured FRONTEND IMPLEMENTATION REPORT. Use when building or updating Next.js pages and components in a sprint. Trigger with "implement frontend sprint", "build Next.js feature". Subagent · jeremylongshore/tons-of-skills-marketplace
- Multi Designs multi-cloud strategies including provider selection, workload placement, lock-in assessment, and portability roadmaps — with explicit tradeoff framing on complexity vs. benefit. Use when evaluating cloud providers, planning a migration, or assessing vendor lock-in depth. Trigger with \"design our multi-cloud strategy\", \"assess our cloud lock-in\". Subagent · jeremylongshore/tons-of-skills-marketplace