pre-submission-review
Skill12 starsChanged 19 days agoMITView on GitHub
Thorough AI review of a lab paper before it is submitted, required by the lab's AI policy. Read-only on the manuscript - it produces a numbered findings file for the author to decide on, and never edits or drafts prose. Use when the user asks for a pre-submission check or final review of their own paper, or says a paper is about to be submitted. Not for manuscripts received for peer review (the venue's AI policy governs those), and not for audits of published work (see reproducibility-audit).
In this repository14 other files it gives its agents.
- adversarial-protocol-reviewSkill
- babyview-datasetSkill
- cdi-vocabulary-dataSkill
- cran-safe-releaseSkill
- gcp-large-stanSkill
- psis-loo-chunkedSkill
- quarto-bookSkill
- redivisSkill
- remote-vm-gotchasSkill
- reproducibility-auditSkill
- rmd-qmd-manuscript-collabSkill
- shiny-to-datapageSkill
- stan-mixing-cold-startSkill
- wordbankSkill
The file
We split this skill into the rules it gives an agent
11 rules. About 0 are common, 10 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈10
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 28
Review from a fresh context: If this session helped build the analysis or the paper, run the review in a fresh subagent or session, as in …
- Distinctive: line 30
Participant data rules still apply: Check numbers against aggregate outputs and code.
- Distinctive: line 31
Don't open raw data containing identifiers, video, audio, or free text to do it.
- Distinctive: line 38
Citations: Check that each cited work exists, that its bibliography entry is correct, and that it supports the claim attached to it.
- Distinctive: line 42
Claims against evidence: Look for causal language from correlational designs, generalization beyond the sample, exploratory results …
- Distinctive: line 47
Figures and tables: Look at them. Check them against their captions and against what the text says they show.
- Distinctive: line 51
Argument and clarity: Look for internal contradictions, logical gaps, undefined or inconsistently used terms, and places a reader would get …
- Distinctive: line 53
Required statements: Check for the AI disclosure statement, which every paper needs even if no AI was used.
- Very specific: line 59
Write pre_submission_review_<YYYY-MM-DD>.md next to the manuscript.
- Distinctive: line 71
Decision column: leave it blank for the author, since the policy requires a decision on each finding.
- Distinctive: line 80
Stop and hand the file to the author.
≈ “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
Pre-submission review
Lab policy: no paper is submitted before it has been reviewed by the author, often several times, and then by a thorough AI agent. Authors need not accept every suggestion, since some will be wrong, but they must consider each one. Source: https://babieslearninglanguage.blogspot.com/2026/10/my-labs-ai-policies-and-norms.html
This review comes after the author's own passes and does not replace them. Never say a paper is "ready to submit"; report what you checked and what you found.
The hard rule
Do not edit the manuscript, and do not draft replacement text. Lab papers contain no AI-authored prose, so a suggested sentence is a way of getting AI text into the paper. Describe the problem and where it is; the author writes the fix. The only file you create is the findings file.
Setup
- Gather the rendered manuscript, its source, the analysis code and outputs, the prereg, and the bibliography. List anything missing as a limit on the review.
- Note the version reviewed (commit hash, or file name and date).
- Review from a fresh context. If this session helped build the analysis or the paper, run the review in a fresh subagent or session, as in adversarial-protocol-review.
- Participant data rules still apply. Check numbers against aggregate outputs and code. Don't open raw data containing identifiers, video, audio, or free text to do it.
What to check
- Numbers. Compare every reported number with the rendered output or the code that produces it: statistics, sample sizes, exclusions, and numbers repeated between the abstract, text, tables, and figures.
- Citations. Check that each cited work exists, that its bibliography entry is correct, and that it supports the claim attached to it. Verify against the paper itself or a source you actually opened, never from memory. Report anything you couldn't check as "unverified", not as an error.
- Claims against evidence. Look for causal language from correlational designs, generalization beyond the sample, exploratory results presented as confirmatory, and an abstract or conclusion that says more than the results do.
- Methods against prereg and code. Compare the sample, exclusions, measures, and analysis specification, and check that deviations are disclosed.
- Figures and tables. Look at them. Check them against their captions and against what the text says they show.
- Validity. For numeric claims, apply adversarial-protocol-review: what could manufacture this result, or hide a real one?
- Argument and clarity. Look for internal contradictions, logical gaps, undefined or inconsistently used terms, and places a reader would get lost.
- Required statements. Check for the AI disclosure statement, which every paper needs even if no AI was used. Also check data and code availability statements, and the venue's requirements if you know the venue.
Findings file
Write pre_submission_review_<YYYY-MM-DD>.md next to the manuscript. Don't commit it
unless asked. Start with the version reviewed, the model used for the review, a short
summary of the most serious problems, and what you did not or could not check. Then:
| # | Severity | Location | Finding | Evidence | Author decision and reason |
|---|----------|----------|---------|----------|----------------------------|
| 1 | Must check | Results, para 3 | Text says N = 212; output gives 207 | `outputs/sample.csv` | |- Severity:
Must check(could be a factual error or invalidate a claim),Consider(a real weakness that's the author's call), orMinor. - Decision column: leave it blank for the author, since the policy requires a decision on each finding. Don't fill it in or mark findings as resolved.
- Evidence: give something the author can check. If you aren't sure, say so in the finding.
- Don't pad. Report only real problems, ranked by severity, and say so if a category turned up nothing.
Afterwards
Stop and hand the file to the author. If they ask, list the models and uses you can document, as notes for the disclosure statement they will write. After revisions, re-run on the new version in a new findings file.
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.

