Works with the AI Agents you already use
Test-Theatre Gate: Mutation & Fuzz Check
Tests can run the code without checking what it returns.
$15
Test-Theatre Gate: Mutation & Fuzz Check
Example session with this skill installed
The coding agent added discounts and a checkout guard to discount.mjs and says all tests pass. Before I merge, check whether those tests actually protect the logic, and whether canCheckout survives bad input.
- Read your context and instructions
- Compiled the test-theatre gate
Baseline: npm test passes. I ran test-theatre-gate on discount.mjs.
$ node scripts/witness.js mutate discount.mjs
mutation gate: discount.mjs …
{
"total": 6,
"capped": false,
"killed": 3,
"survived": [
{ "line": 3, "mutation": "> → >=",
"snippet": "if (total > 50) return total - 5;" },
{ "line": 2, "mutation": "&& → ||",
"snippet": "if (total >= 100 && isMember) return total * 0.9;" },
{ "line": 8, "mutation": "return true → return false",
"snippet": "return true;" }
],
"ignored": [],
"rejectedExemptions": [],
"score": 0.5,
"clean": false
}
✗ 3 mutant(s) SURVIVED — those lines are test-theatre.
$ node scripts/witness.js fuzz discount.mjs canCheckout
{ "throwsOn": [
{ "input": "null", "error": "Cannot read properties of null (reading 'items')" },
{ "input": "undefined", "error": "Cannot read properties of undefined (reading 'items')" },
{ "input": "empty object", "error": "Cannot read properties of undefined (reading 'length')" },
… 17 more inputs, same pattern …
],
"neverThrows": false }
discount.mjs was restored unchanged after the run.
What this means
- No test checks the $50 boundary: a test for discount(50, false) === 50 would kill line 3.
- No test gives a big order to a non-member, so && vs || goes unnoticed: add discount(200, false) === 195.
- The only "checkout works" test asserts the result isn't undefined, so returning false passes too: assert canCheckout({ items: [1] }) === true.
- canCheckout throws on null and on objects without items. Add a guard if it can get bad input.
I'd add these four tests before merging.
Connects securely to your tools. The creator never sees your data.
About this skill
Agent Trust: are the agent's tests actually testing anything?
When an agent writes both the code and the tests, a passing suite proves less than it seems. Tests can run the code without checking what it returns. Mutation testing shows this: change the code on purpose, and if the tests still pass, they weren't guarding that line.
What it does
mutate: for one source file, it:
- Times a baseline run of your test command (default
npm test) - Applies one mutation at a time:
>=↔>,<=↔<,===↔!==,==→!=,&&↔||,return true↔return false,+ 1↔- 1(code only, not comments) - Reruns your tests for each mutant: a failing test "kills" the mutant; a passing suite means it survived
- Restores the original file, and self-heals from an atomic backup if a previous run was killed
fuzz: calls an exported function with hostile inputs (null, undefined, NaN, Infinity, empty and huge strings and arrays, circular objects, toxic getters and more) and reports every input that throws.
Reviewed exceptions can be recorded in witness.baseline.json with a written reason (20+ characters); short reasons are rejected.
When an agent should use it
- An agent wrote code and tests and you want to know if the tests mean anything
- Before merging a PR whose tests all pass
- Hardening a function that must never throw on bad input
What it outputs
JSON + a one-line summary: total mutants, killed, survived (line, mutation, snippet), ignored (baselined), rejected exemptions, score and a clean flag. Fuzz returns the inputs that threw and a neverThrows flag. Exit 0 = clean; non-zero = survivors or throwing inputs. The skill tells the agent to propose a test that kills each survivor.
Limitations
- Built for JavaScript/TypeScript projects (fuzz needs an ES module). Mutation is text-based and only touches spaced operators, so it is not a full mutation framework.
- Mutates one file per run and reruns your whole test command for each mutant, so slow suites take time.
--caplimits the number of mutants and--timeoutbounds each run. - Some survivors are genuine "equivalent mutants" that no test could catch. Record those in the baseline with a reason rather than forcing a test.
Open source, packaged skill
Original work by Simon Gant. The core logic is public under the MIT licence (witness). This listing is the packaged, tested agent skill: SKILL.md workflow, CLI and docs. Requires Node.js 18+, zero dependencies, no network, no API keys.
Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse Claude Skills for LLM Ops.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before buying a skill.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Money-back guarantee
Doesn't do what its page promises? You get your money back.
Trust & safety
Security scan
Security scan passed today
- Software
Node.js 18+Project test runner
Permissions
Runs local Node.js scripts (`node scripts/witness.js` and `node scripts/runner.js`) through the agent's shell. Spawns the project's test command (default npm test) and temporarily edits the target source file, always restoring it, including from an atomic backup if a previous run was killed. No network access, no environment variables read.