Method Audit

SkillDev tools

Extract and compare data-collection methods across a set of empirical papers. Use when the user needs a cross-paper methods matrix or wants to assess how a literature gathers evidence.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Method Audit skill

What this skill tells your AI

The instructions your AI receives, as published by flonat/flonat-research in skills/method-audit/SKILL.md and read by ahel’s review.

Reverse-engineer the data collection and empirical methods across a corpus of papers. Produce a critical comparison table that surfaces methodological blind spots.

Output Path

Per rules/review-artefact-routing.md (auto-loads in research projects (path-scoped to paper-*/ and paper/)):

  • Source slug: method-audit
  • Write reports to: reviews/_project/method-audit/<YYYY-MM-DD-HHMM>.md inside the project. Path is relative to the research project root, not the Task-Management repo.
  • Never at project root (./CRITIC-REPORT.md-style filenames are forbidden — pre-rule layout).
  • Idempotency: timestamps include hour+minute (HHMM) to disambiguate same-day runs; never overwrite an earlier run's report.
  • Index update: if reviews/INDEX.md exists, write a one-line entry under "Latest per source" pointing at the new file. Otherwise review-recap will rebuild the index next time it runs.
  • Infrastructure repos (Task-Management, atlas-workspace, etc.): this section does not apply — the path-scoped rule won't load there.

When to Use

  • Writing a methodology section — need to justify your approach relative to the literature
  • Reviewing empirical papers — need to compare data quality across studies
  • Identifying methodological gaps — what approach has nobody tried yet?
  • Preparing a replication or extension — need to understand exactly how prior work was done

When NOT to Use

  • Theoretical papers — use an installed theoretical-comparison workflow instead
  • Single-paper deep read — use split-pdf
  • Your own research design — use causal-design or experiment-design
  • Code review — use the code-review agent

Input

A .bib file, PDF directory, topic description, or list of papers. If ambiguous, ask.

Workflow

Phase 1: Corpus Assembly

Assemble 10-20 empirical papers from the supplied bibliography or directory, or through configured scholarly-search tools. Prioritise papers with empirical content and filter out pure theory, editorials, and commentaries.

Phase 2: Method Extraction

For each paper, read using split-pdf methodology. Extract:

  1. Research design — experimental, quasi-experimental, observational, survey, qualitative, mixed
  2. Data source — where the data comes from (name the dataset, survey instrument, or archive)
  3. Sample
    • Population and sampling frame
    • Sample size (N)
    • Unit of observation
    • Time period
    • Response rate (if survey)
    • Attrition (if longitudinal)
  4. Variables
    • Dependent variable(s) and how measured
    • Key independent variable(s) and how measured
    • Controls included
  5. Estimation strategy
    • Statistical method (OLS, IV, DiD, RCT, qualitative coding, etc.)
    • Identification strategy (what makes the estimate causal, if claimed)
    • Robustness checks reported
  6. Biases acknowledged — what limitations the authors discuss
  7. Biases NOT acknowledged — what you can spot that they don't mention

Phase 3: Comparative Analysis

3.1 Methods Comparison Table
PaperDesignData SourceNPeriodMethodID StrategyResponse Rate

Sort by sample size (largest first).

3.2 Technique Distribution

Count how many papers use each:

  • Design type (experimental, observational, etc.)
  • Estimation method (OLS, IV, DiD, etc.)
  • Data type (survey, admin, experimental, scraped, etc.)

Flag any technique that is dominant (>60% of papers) — this signals a methodological monoculture.

3.3 Bias Audit

For each paper, classify biases:

PaperBiases AcknowledgedBiases MissedSeverity

Common missed biases to check for:

  • Selection bias — non-random sampling without correction
  • Measurement error — self-reported outcomes, proxy variables
  • External validity — single-country, single-firm, WEIRD samples
  • Survivorship bias — studying only firms/people that survived
  • Publication bias — significant results overrepresented
  • Endogeneity — causal claims without credible identification
  • Multiple testing — many outcomes tested without correction
3.4 Methodological Gaps
  • Designs nobody has tried (e.g., no RCT in a field of observational studies)
  • Data sources nobody has used (e.g., admin data when everyone uses surveys)
  • Robustness checks nobody runs (e.g., no placebo tests, no sensitivity analysis)
  • Populations understudied (e.g., only US data in a global phenomenon)

Phase 4: Output

Write to METHOD-AUDIT.md in the project directory.

Output Format

# Method Audit: [Topic]

**Date:** YYYY-MM-DD
**Corpus:** [N] empirical papers
**Dominant design:** [Most common research design]
**Dominant method:** [Most common estimation method]

## Comparison Table

| Paper | Design | Data | N | Period | Method | ID Strategy | Biases Noted |
|-------|--------|------|---|--------|--------|-------------|-------------|

## Technique Distribution

| Category | Count | Papers |
|----------|-------|--------|

## Bias Audit

### Commonly Acknowledged
- [Bias type] — mentioned by [N] papers

### Commonly Missed
- [Bias type] — present in [N] papers but acknowledged by [M]
  - **Why it matters:** [Impact on findings]
  - **Papers affected:** [List]

## Methodological Gaps

1. **No [design/method] studies** — [Why this matters]
2. **Understudied population:** [Who is missing]
3. **Missing robustness check:** [What should be tested]

## Implications for Your Research

- **Opportunity:** [What methodological gap you could fill]
- **Risk:** [What bias to watch for in your own design]
- **Benchmark:** [What sample size / design quality is expected in this field]

Cross-References

SkillWhen to use instead/alongside
Installed theoretical-comparison workflowFor theoretical rather than methodological comparison
causal-designTo design your own identification strategy
experiment-designTo design experiments or surveys
replication-auditTo check which findings have been replicated

Signals

GitHub stars
133
Forks
24
Last commit
Aug 2026
Advanced
Catalog kind
skill
Gateway key
method-audit
Source
github.com/flonat/flonat-research