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".
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-pipelinesComplete 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.