SkillAgentSearch skills...

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-test

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

87/100

Category

Automation

Supported Platforms

Universal

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.

Substance
26/30
Structure
20/20
Description
15/15
Adoption
12/20
Freshness
15/15

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 found

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.

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.

SkillScoreStarsUpdatedFormat
nw-mutation-test (this skill)by nWave-ai876172mo agoSKILL.md
Agent-Reachby Panniantong100112.7k9d agoCLAUDE.md
rufloby ruvnet10082.0ktodayCLAUDE.md
Claude-Code-Game-Studiosby Donchitos10039.9k8d agoCLAUDE.md
Scraplingby D4Vinci100103.9ktodayMCP 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.

name: 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 extraction
  • scripts/mutation/generate_scoped_configs.py - Automated config generation (if available)

Pre-Invocation

Orchestrator performs before delegating:

  1. Extract files — Read execution-log.json and extract implementation files from completed_steps[].files_modified.implementation. Gate: file list non-empty.
  2. Verify on disk — Check all extracted files exist on disk. Gate: zero missing files.
  3. Detect language — Scan config files (pyproject.toml, pom.xml, package.json, etc.) to select tool. Gate: language identified.
  4. Confirm tests pass — Run pytest -x {test_scope} (or equivalent). Gate: exit code 0, no failures.
  5. Ensure mutation venv — For Python, verify .venv-mutation/ exists with cosmic-ray installed. Gate: cosmic-ray --version succeeds.

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):

  1. Restore source files — Run git checkout -- src/ tests/. Gate: working tree clean (no mutations remain).
  2. 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:

  1. >= 80% PASS — Proceed to next wave.
  2. 70-80% WARN — Review surviving mutants, document findings, proceed with caution.
  3. < 70% FAIL — Add tests targeting surviving mutants before proceeding.

Skip conditions (each requires documented justification in mutation-report.md):

  1. No tool for language — No mutation framework available for detected language.
  2. Project opt-out — .mutation-config.yaml has skip: true with justification.
  3. 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

View on GitHub
GitHub Stars617
CategoryAutomation
Updated2mo ago
Forks63

Languages

Python

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions