paper-code-audit

Compare a paper's claims against its public codebase and report mismatches.

Updated Sep 11, 2026
One-click install
npx skills add https://github.com/cameronbracken/waterology-research --skill paper-code-audit-cameronbracken
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: paper-code-audit
Source: https://github.com/cameronbracken/waterology-research/tree/main/skills/paper-code-audit
Command: npx skills add https://github.com/cameronbracken/waterology-research --skill paper-code-audit-cameronbracken

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Researchers and reviewers often need to verify whether a published paper's methods, defaults, and metrics actually match its released code. Manually cross-checking claims against implementation is slow and error-prone, and README files alone rarely reveal real behavior. ## Core Features & Use Cases - Claim-to-Code Comparison: Reads the implementation, tests, configuration, and history to compare the paper's methods, defaults, metrics, and data handling with the actual code. - Reproducibility Risk Detection: Reports missing implementations, ambiguous defaults, unstated seeds or RNG kinds, and reproduction risks. - Structured Audit Report: Produces a single report at docs/<slug>-audit.md ending with a Sources section of direct paper and repository URLs, optionally delegating evidence gathering to researcher and verifier agents. - Use Case: Before citing or building on a paper, ask for an audit of the paper against its GitHub repository to confirm the reported metrics and default hyperparameters match the released implementation. ## Quick Start Audit this paper against its public repository and write a report of any mismatches between its claims and the implementation.

Frequently Asked Questions about paper-code-audit

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

FAQPage Schema
How do I audit a paper against its code repository?▼

Provide the paper and its public repository, then the audit reads the implementation, tests, configuration, and history to compare methods, defaults, metrics, and data handling. The result is a single report at docs/<slug>-audit.md listing mismatches and reproduction risks.

How to check if a research paper is reproducible?▼

Reproducibility checking compares the paper's stated methods, seeds, RNG kinds, and defaults against the released code. The audit flags missing implementations, ambiguous defaults, and unstated randomness that would prevent reproducing the reported results.

Can I audit a paper using only its README?▼

No. The audit explicitly avoids inferring behavior from the README alone and instead inspects the actual implementation, tests, configuration, and repository history, using tools like Git or gh when local inspection requires them.

What does the paper audit report contain?▼

The report documents missing implementations, ambiguous defaults, claim-code mismatches, unstated seeds or RNG kinds, and reproduction risks. It is saved as exactly one file at docs/<slug>-audit.md and ends with a Sources section of direct paper and repository URLs.

When should I delegate parts of a code audit to agents?▼

For broad, non-trivial audits, evidence gathering can be delegated to a researcher agent and source and citation checks to a verifier agent through the runtime's agent mechanism. Each brief should state ownership and expected artifact paths explicitly.