nw-mutation-test
Run an explicit mutation probe over a named production delta, or support the project-level nightly-delta policy. Disabled by default.
Install / Use
npx skills add nWave-ai/nWave --skill nw-mutation-testInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
Our assessment of nw-mutation-test
nw-mutation-test scores 87/100 on our quality scale, 1713th of 2,769 Automation skills we index.
Its SKILL.md is 5.6 KB long, well organised into 16 sections with 4 code examples: a solid amount of guidance for an agent.
It has 617 GitHub stars, a meaningful sign that others use it.
Maintenance, license and trust
- The repository was last updated about 2 months ago, so nw-mutation-test is actively maintained.
- Our last check on 2026-10-11 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-10-07. Automated pattern scan on 2026-10-07. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
nw-mutation-test compared with similar skills
All 4 of these similar skills score higher than nw-mutation-test; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| nw-mutation-test (this skill)by nWave-ai | 87 | 617 | 2mo ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.7k | 9d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 82.0k | today | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 39.9k | 8d ago | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 103.9k | today | MCP Server |
Frequently asked questions
- How do I install nw-mutation-test?
- Run
npx skills add nWave-ai/nWave --skill nw-mutation-test. The install tabs above show the steps for each supported agent. - Which AI agents does nw-mutation-test work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is nw-mutation-test safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is nw-mutation-test still maintained?
- The repository was last updated about 2 months ago, so nw-mutation-test is actively maintained.
Skill content
View source on GitHubname: nw-mutation-test description: "Runs feature-scoped mutation testing to validate test suite quality. Use after implementation to verify tests catch real bugs (kill rate >= 80%)." user-invocable: true argument-hint: '[feature-id] - Optional: --threshold=[75|80|85] --language=[auto|python|java|javascript]'
NW-MUTATION-TEST: Feature-Scoped Mutation Testing
Wave: QUALITY_GATE Agent: Crafter (nw-software-crafter)
Overview
Run mutation testing against implementation files from the current feature. Extracts targets from the execution-log.json (see Target extraction)|generates feature-scoped configs|delegates to software-crafter. Uses cosmic-ray (Python)|PIT (Java)|Stryker (JS/TS/C#).
Mutation Testing Strategy
Projects declare a strategy via ## Mutation Testing Strategy in CLAUDE.md: per-feature | nightly-delta | pre-release | disabled.
Default (when unspecified): nightly-delta — the recommended mode. CI runs mutmut nightly against modules changed since the last run (the delta), keeping per-feature delivery gates fast. /nw-mutation-test performs an explicit, on-demand feature-scoped run regardless of strategy; under nightly-delta the in-wave Phase 5 gate is skipped and the work is handled by the CI nightly pipeline.
Target extraction
Implementation files are selected from the execution-log.json (completed_steps[].files_modified.implementation).
Context Files Required
docs/feature/{feature-id}/deliver/execution-log.json- Implementation file extractionscripts/mutation/generate_scoped_configs.py- Automated config generation (if available)
Pre-Invocation
Orchestrator performs before delegating:
- Extract files — Read
execution-log.jsonand extract implementation files fromcompleted_steps[].files_modified.implementation. Gate: file list non-empty. - Verify on disk — Check all extracted files exist on disk. Gate: zero missing files.
- Detect language — Scan config files (pyproject.toml, pom.xml, package.json, etc.) to select tool. Gate: language identified.
- Confirm tests pass — Run
pytest -x {test_scope}(or equivalent). Gate: exit code 0, no failures. - Ensure mutation venv — For Python, verify
.venv-mutation/exists with cosmic-ray installed. Gate:cosmic-ray --versionsucceeds.
Agent Invocation
@nw-software-crafter
Execute mutation testing for project {feature-id}.
Context to pass inline (agent has no Skill access):
- Project ID
- Implementation file list (from execution-log.json)
- Test scope path (e.g.,
tests/des/) - Kill rate threshold (default: 80%)
- Language and tool selection
Configuration:
- threshold: 80 (percentage, minimum kill rate)
- approach: feature-scoped (one config per component, scoped test commands)
- config_generator:
scripts/mutation/generate_scoped_configs.py(preferred over manual)
Output file: docs/feature/{feature-id}/deliver/mutation/mutation-report.md
Examples
Example 1: Python project with config generator
/nw-mutation-test des-hook-enforcement tests/des/
Reads the execution-log.json, runs generate_scoped_configs.py des-hook-enforcement, delegates to software-crafter with per-component configs. Agent runs cosmic-ray, produces mutation-report.md.
Example 2: Python project without config generator
/nw-mutation-test auth-upgrade tests/auth/
Extracts files manually from the execution-log.json, creates single cosmic-ray config with module-path = [file1, file2, ...] and test-command = "pytest -x tests/auth/", delegates to agent.
Example 3: Non-Python project
/nw-mutation-test payment-gateway tests/payment/
Detects package.json, selects Stryker, delegates with Stryker-specific instructions.
Success Criteria
- [ ] Implementation files extracted from execution-log.json
- [ ] All implementation files verified on disk
- [ ] Mutation testing executed without errors
- [ ] Per-file breakdown in mutation-report.md
- [ ] Kill rate meets threshold (>= 80% PASS, 70-80% WARN, < 70% FAIL)
- [ ] Source files restored to HEAD after mutation run (git checkout -- src/ tests/)
Post-Mutation Safety (mandatory)
After EVERY mutation run (success, failure, or interruption):
- Restore source files — Run
git checkout -- src/ tests/. Gate: working tree clean (no mutations remain). - Verify no corruption — Confirm test suite still passes after restore. Gate:
pytest -x {test_scope}exits 0.
Mutation tools apply mutations directly to source files. An interrupted run can leave corrupted code (e.g. is not None -> is None). Agent MUST execute these steps even if the run errors out.
Quality Gate
Kill rate thresholds:
- >= 80% PASS — Proceed to next wave.
- 70-80% WARN — Review surviving mutants, document findings, proceed with caution.
- < 70% FAIL — Add tests targeting surviving mutants before proceeding.
Skip conditions (each requires documented justification in mutation-report.md):
- No tool for language — No mutation framework available for detected language.
- Project opt-out —
.mutation-config.yamlhasskip: truewith justification. - Broken test suite — Pre-invocation step 4 fails; fix tests before mutation testing.
Note: Python projects require mutation testing. All skips need documented justification.
Next Wave
Handoff To: Phase 8 - Finalize (orchestrator continues develop.md workflow)
Deliverables: docs/feature/{feature-id}/deliver/mutation/mutation-report.md
Expected Outputs
docs/feature/{feature-id}/deliver/mutation/
mutation-report.md
cosmic-ray-*.toml (ephemeral)
Related Skills
Agent-Reach
112.7kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
82.0k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
Claude-Code-Game-Studios
39.9kTurn Claude Code into a full game dev studio — 49 AI agents, 75 workflow skills, and a complete coordination system mirroring real studio hierarchy.
Scrapling
103.9k🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
