method-audit
Skill150 starsChanged 9 days agoMITView on GitHub
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.
In this repository89 other files it gives its agents.
- AGENTS.mdAGENTS.md
- docs/agents.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- beamer-deckSkill
- bib-coverageSkill
- bib-filterSkill
- bib-parseSkill
- brief-compliance-checkSkill
- camera-readySkill
- causal-designSkill
- checkpointSkill
- code-archaeologySkill
- compile-knowledgeSkill
- computational-experimentsSkill
- cross-language-checkSkill
- data-analysisSkill
- devils-advocateSkill
- docs-consistencySkill
- docxSkill
- experiment-designSkill
- grill-meSkill
- handoffSkill
- ideasSkill
- init-project-courseSkill
- init-project-lightSkill
- init-project-orchestrationSkill
- init-projectSkill
- insights-deckSkill
- interview-meSkill
- knowledge-lintSkill
- latex-diffSkill
- latex-health-checkSkill
- latex-polishSkill
- latex-postersSkill
- latex-scaffoldSkill
- latexSkill
- latex-templateSkill
- lean-checkSkill
- math-proofSkill
- mcp-builderSkill
- multi-perspectiveSkill
- numerical-checkSkill
- pdfSkill
- pipeline-manifestSkill
- playwright-cliSkill
- postmortemSkill
- pre-commit-auditSkill
- pre-submission-reportSkill
- project-deckSkill
- project-safetySkill
- proof-readabilitySkill
- proofreadSkill
- python-envSkill
- quarto-deckSkill
- reorgSkill
- replication-auditSkill
- replication-packageSkill
- retarget-journalSkill
- review-clusterSkill
- review-responseSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
2 rules. About 0 are common, 0 are distinctive, and 2 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈0
Distinctive · estimate
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 21
Index update: if reviews/INDEX.md exists, write a one-line entry under "Latest per source" pointing at the new file.
- Very specific: line 116
Write to METHOD-AUDIT.md in the project directory.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Method Audit
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>.mdinside 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.mdexists, write a one-line entry under "Latest per source" pointing at the new file. Otherwisereview-recapwill 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-designorexperiment-design - Code review — use the
code-reviewagent
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:
- Research design — experimental, quasi-experimental, observational, survey, qualitative, mixed
- Data source — where the data comes from (name the dataset, survey instrument, or archive)
- Sample
- Population and sampling frame
- Sample size (N)
- Unit of observation
- Time period
- Response rate (if survey)
- Attrition (if longitudinal)
- Variables
- Dependent variable(s) and how measured
- Key independent variable(s) and how measured
- Controls included
- Estimation strategy
- Statistical method (OLS, IV, DiD, RCT, qualitative coding, etc.)
- Identification strategy (what makes the estimate causal, if claimed)
- Robustness checks reported
- Biases acknowledged — what limitations the authors discuss
- Biases NOT acknowledged — what you can spot that they don't mention
Phase 3: Comparative Analysis
3.1 Methods Comparison Table
| Paper | Design | Data Source | N | Period | Method | ID Strategy | Response 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:
| Paper | Biases Acknowledged | Biases Missed | Severity |
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
| Skill | When to use instead/alongside |
| Installed theoretical-comparison workflow | For theoretical rather than methodological comparison |
causal-design | To design your own identification strategy |
experiment-design | To design experiments or surveys |
replication-audit | To check which findings have been replicated |
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

