experiment-audit

Validates experiment integrity by checking provenance, metrics behavior, file existence, and produces audit reports with verdicts.

Updated May 20, 2026
One-click install
npx skills add https://github.com/lightrain-a/medtrace-aris --skill experiment-audit-lightrain-a
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: experiment-audit
Source: https://github.com/lightrain-a/medtrace-aris/tree/main/.vendor/aris/skills/experiment-audit
Command: npx skills add https://github.com/lightrain-a/medtrace-aris --skill experiment-audit-lightrain-a

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents overconfident reporting by auditing whether an experiment’s “ground truth,” metrics, and reported files are genuinely supported by the repository’s code and artifacts.

Core Features & Use Cases

  • Cross-model integrity review: Uses an executor to collect artifact paths and an independent reviewer model to judge integrity from the actual files.
  • Fraud pattern checks: Detects fake ground truth, score normalization fraud, phantom/unverifiable results, dead metrics, and over-claimed scope.
  • Non-blocking pipeline integration: Produces EXPERIMENT_AUDIT.md and EXPERIMENT_AUDIT.json and tags claims as warned without halting downstream steps.

Quick Start

Use the experiment-audit skill after experiments finish by giving it the experiment directory or the results path to audit.

Frequently Asked Questions about experiment-audit

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

FAQPage Schema
How do I verify experiment integrity before making claims in a research paper?

Experiment integrity verification requires auditing ground-truth provenance, metric normalization behavior, and result-file existence against repository evidence. You provide the experiment directory path, and a cross-model reviewer generates EXPERIMENT_AUDIT.md and EXPERIMENT_AUDIT.json with PASS, WARN, or FAIL verdicts.

What is metric normalization fraud and how is it detected?

Metric normalization fraud involves manipulating score normalization to artificially inflate experiment results. Detection is performed by a read-only cross-model reviewer pass that validates ground-truth provenance and checks for dead metrics, phantom results, and over-claimed scope against actual repository artifacts.

How do I check for fake ground truth or unverifiable results in my repository?

Checking for fake ground truth involves auditing whether reported files and scores are genuinely supported by the repository's code and artifacts. The audit process applies path-only artifact collection to verify result-file existence and scope alignment, generating a JSON report with explicit verdicts.

Does experiment auditing block my downstream pipeline if it detects a fraud pattern?

Experiment auditing is non-blocking and will not halt downstream pipeline steps. It produces EXPERIMENT_AUDIT.md and EXPERIMENT_AUDIT.json files and tags unsupported claims as warned, allowing the pipeline to continue while preventing overconfident reporting.

When do I need to run an experiment audit during the research workflow?

An experiment audit is needed after experiments complete and before making claims in narrative reports or papers. It specifically checks ground-truth provenance, metric normalization behavior, result-file existence, and scope alignment against repository evidence to prevent overconfident reporting.

Can I use a cross-model reviewer to validate result files without modifying them?

Yes, experiment integrity auditing uses a read-only cross-model reviewer pass to judge integrity from actual files. The executor collects path-only artifact references, ensuring the validation of ground truth and metrics occurs without modifying the original repository evidence.