mutation-score-report

Aggregate per-session mutation-score records into a markdown report.

1|Updated Mar 15, 2026
One-click install
npx skills add https://github.com/paulingham/.claude --skill mutation-score-report
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mutation-score-report
Source: https://github.com/paulingham/.claude/tree/main/skills/mutation-score-report
Command: npx skills add https://github.com/paulingham/.claude --skill mutation-score-report

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Aggregate per-session mutation-score records into a single, actionable report for soak monitoring and gate decisions.

Core Features & Use Cases

  • Aggregates per-session mutation-score.jsonl files to produce a consolidated view of soak progress across sessions.
  • Evaluates the number of distinct sessions and the median mutation_score, plus tool availability to gauge reporting feasibility.
  • Helps operators decide whether to flip the mutation-score-gate from advisory to enforcing and provides periodic health checks.

Quick Start

Run the mutation-score-report to generate the latest soak health report.

Frequently Asked Questions about mutation-score-report

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

FAQPage Schema
How do I aggregate per-session mutation scores into a single soak health report?

To aggregate mutation scores, read per-session mutation-score.jsonl files to compute distinct sessions and the median mutation score. The tool outputs a consolidated markdown report to evaluate soak readiness and gate enforcement decisions.

What is a mutation score report used for in soak testing?

A mutation score report evaluates soak readiness and monitors test coverage across multiple sessions. By aggregating per-session records, it informs operators whether to flip the mutation-score-gate from advisory to enforcing for continuous health checks.

How do I generate a consolidated mutation score report from JSONL files?

Generate the report by reading metrics from $HARNESS_DATA/metrics/*/mutation-score.jsonl. The process computes distinct sessions and median mutation_score, writing the final markdown report to $HARNESS_DATA/metrics/reports/{YYYY-MM-DD}-mutation-score.md.

Does the mutation score report require external dependencies to run?

No external dependencies are required to generate the mutation score report. The skill independently reads available tool data and JSONL files to gauge reporting feasibility and compute the median mutation score for the soak health snapshot.

When should I flip my mutation score gate from advisory to enforcing?

Flip the mutation-score-gate to enforcing when the aggregated median mutation score across distinct sessions demonstrates stable test coverage. The report provides the actionable soak health data needed to make this readiness decision confidently.