skills/11-James-Traina-compound-science/skills/submission-guide/SKILL.md
This skill covers academic journal submission, referee responses, and revision management. Use when the user is preparing a manuscript for submission, formatting for a specific journal, responding to referees, or managing revisions. Triggers on "submit", "referee", "revision", "R&R", "response letter", "journal", "formatting", "submission", "resubmit", "cover letter", "referee report", "revise and resubmit".
npx skillsauth add brycewang-stanford/Awesome-Agent-Skills-for-Empirical-Research submission-guideInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Reference for the full journal submission lifecycle: pre-submission preparation, journal-specific formatting, referee response strategy, and revision management. Covers conventions for top journals in economics, finance, political science, sociology, marketing, and statistics.
Use when the user is:
Skip when:
causal-inference or empirical-playbook skill)structural-modeling skill)reproducible-pipelines skill)Complete every item before submitting. Missing any one of these is a common reason for desk rejection or delayed processing.
journal-referee agent for an adversarial review and the econometric-reviewer agent to audit tables against code output.* p<0.10, ** p<0.05, *** p<0.01. Some journals (QJE) discourage stars entirely.For per-journal tables covering spacing, abstract limits, stars conventions, submission systems, and special requirements across Economics (Top 5, AEJ, Field), Finance, Political Science, Sociology, Marketing, and Statistics journals, see: references/journal-profiles.md
Quick lookup:
ecta.clsThe response letter is the most important document in the revision. Structure: Opening (thank editor and referees) → summary of major changes (3-5 sentences) → point-by-point responses organized by referee, with Major and Minor sections. Quote each referee comment, then respond with specific page/section references to changes in the revised manuscript. Use tracked changes or color highlighting. For full response templates and revision routing, see references/referee-response-templates.md.
| Principle | Good Example | Bad Example | |-----------|-------------|-------------| | Thank the referee | "This is an excellent point that led us to strengthen Section 4." | "We disagree with the referee's interpretation." | | Be specific about changes | "We have added Table A3 (Online Appendix, p.15) showing results with alternative bandwidth." | "We have addressed this concern." | | Concede gracefully | "The referee is correct that our original discussion was unclear. We have rewritten paragraphs 2-3 of Section 3 to..." | "We believe our original discussion was clear, but we have added a footnote." | | Defend with evidence | "We respectfully maintain our baseline specification because: (1) the Hausman test does not reject (p=0.34, Table A5), (2) results are quantitatively similar with the referee's preferred specification (Table A6)." | "We disagree." | | Never be dismissive | "Thank you for this suggestion. While our setting differs from [Paper] because [reason], we have added a discussion of this connection in footnote 12." | "This comment reflects a misunderstanding of our method." |
Concede when:
Defend when:
Track every referee comment in a table with columns: Ref | # | Comment Summary | Category | Action | Status | Location. Categories: Identification, Data, Inference, Exposition, Literature, Robustness. Rule: every Status cell must be filled before resubmission.
For per-method concern tables (IV, DiD, Structural Estimation, RDD, Matching), including typical phrasing and detailed response strategies, see: references/referee-tactics.md
# Tag each submission and generate diff PDF
git tag -a v1-submitted -m "First submission to AER"
git tag -a v2-submitted -m "Revised submission"
latexdiff old.tex new.tex > diff.tex && pdflatex diff.tex
Reference page numbers from the clean revised manuscript, not the diff. Editors expect a diff PDF alongside the clean revision.
| Round | Focus | Response length | |-------|-------|----------------| | R1 (first R&R) | Address all major concerns thoroughly. Over-deliver on robustness. | Detailed, often 15-30 pages | | R2 (second R&R) | Fine-tune remaining concerns. Show that R1 issues are fully resolved. | Concise, 5-15 pages | | R3 (rare, conditional accept) | Minor copyediting, final clarifications only. | Very brief, 2-5 pages |
After each round: wait 24-48 hours → read all reports → categorize (major/minor) → build response matrix → prioritize identification concerns → draft major responses → fill minor comments → co-author review → generate diff PDF → submit.
| Decision | Meaning | Typical Next Step | |----------|---------|-------------------| | Desk reject | Editor decided not to send to referees. | Submit elsewhere. Do not appeal unless there is a clear factual error. | | Reject after review | Referees recommended rejection. | Substantially revise and submit elsewhere, incorporating feedback. | | Revise and resubmit (R&R) | Paper has potential but needs significant revision. | Address all comments thoroughly. | | Conditional accept | Minor revisions needed. | Make the requested changes precisely. Do not introduce new results. | | Accept | Paper accepted. | Prepare camera-ready version and replication package. |
| Factor | Guidance | |--------|----------| | Conference presentations | Submit after presenting at a major conference — the paper benefits from feedback, and the presentation signals quality. | | Working paper circulation | Post to SSRN/NBER before submission. Journals expect papers to circulate as working papers first. | | Dual submission | Most economics and finance journals prohibit simultaneous submission to multiple journals. Confirm the journal's policy. | | Semester timing | Avoid July-August (editors and referees on vacation). September-November and January-March tend to be faster. | | Market timing | Junior scholars should have papers submitted and preferably under review by September of their market year. |
paper.tex, paper.bbl (compiled bibliography), all figures as PDF\usepackage{hyperref} if it causes issues, ensure \graphicspath is relative.sty filesecon category (econ.EM for econometrics, econ.GN for general)For Quarto users: quarto use template hchulkim/econ-paper-template provides AEA-format output (aea-pdf/aea-html). Always set keep-tex: true since journals require .tex source files.
tools
Recommend AND run open-source AI tools, agents, Claude Code / Codex skills, and MCP servers for any stage of a literature review — searching, reading, extracting, synthesizing, screening, citation-checking, and paper writing. Use when the user asks "what tool should I use to..." OR "install/run/use <tool> to ..." for research/lit-review work: automating a survey or related-work section, PDF→Markdown extraction for LLMs (MinerU/marker/docling), PRISMA / systematic review (ASReview), citation-backed Q&A over PDFs (PaperQA2), wiring papers into Claude/Cursor via MCP (arxiv/paper-search/zotero servers), or chatting with a Zotero library. Ships a launcher (scripts/litrun.py) that installs each tool in an isolated venv and runs it. Curated catalog of 70+ vetted projects. 支持中英文(用于「文献综述工具选型」与「一键安装/运行」)。
development
Route empirical-research requests through the Auto-Empirical Research Skills catalog when this whole repository is installed as one skill in Codex, CodeBuddy, Claude Code, or another IDE. Use to choose and load the right vendored AERS skill for causal inference, econometrics, replication, data acquisition, manuscript writing, peer review and referee responses, citation checking, de-AIGC editing, or full empirical-paper workflows without reading the entire repository at once.
documentation
Use when the project collects primary data or runs a field, lab, or survey experiment, before the intervention begins — write the pre-analysis plan, size the sample from a power calculation, and register with the AEA RCT Registry. Apply after the design is chosen in aer-identification and before any outcome data are seen.
tools
Guide economists to authoritative data sources with explicit, confirmed data specifications before retrieval; interfaces with Playwright MCP to navigate portals and extract real data, not articles about data.