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".
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".
Journal Submission
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.
When to Use This Skill
Use when the user is:
Preparing a manuscript for first submission to an academic journal
Formatting a paper to meet a specific journal's requirements
Writing a response letter to referee reports after receiving an R&R
Managing tracked changes and revision logistics
Anticipating common referee objections for a particular empirical method
Writing a cover letter to the editor
Skip when:
The task is choosing an empirical method (use causal-inference or empirical-playbook skill)
The task is structural estimation implementation (use structural-modeling skill)
The task is setting up a replication package (use reproducible-pipelines skill)
Pre-Submission Checklist
Complete every item before submitting. Missing any one of these is a common reason for desk rejection or delayed processing.
Manuscript
Title: Concise, informative, no unnecessary jargon. Under 15 words is ideal.
Abstract: States the question, method, data, and main finding. Respects journal word limit (typically 100-150 words for econ journals).
Introduction: Clearly states contribution in first two paragraphs. Includes a "roadmap" paragraph at the end.
Literature review: Positions paper relative to 3-5 closest papers. Explains what this paper does that they do not.
Identification section: Formal statement of assumptions, not just prose. Numbered assumptions preferred.
Results: Main results first, robustness second. Do not bury the lead.
Conclusion: No new results. Discuss limitations honestly. Suggest future work briefly.
References: Every citation in text appears in references and vice versa. Use a bibliography manager (BibTeX/BibLaTeX).
Anonymization: Remove all author-identifying information. Check PDF metadata, acknowledgments, file paths in code, dataset names that reveal institution.
Page/word count: Within journal limits. Many journals have strict limits (e.g., AER Papers & Proceedings: 5 pages).
Spell check and grammar: Run a final pass. Typos in the abstract signal carelessness.
Agent review: Run the journal-referee agent for an adversarial review and the econometric-reviewer agent to audit tables against code output.
Tables
Self-contained: Each table has a descriptive title and notes explaining all variables, sample, and significance stars.
Significance stars: Use journal convention. Most econ journals: * p<0.10, ** p<0.05, *** p<0.01. Some journals (QJE) discourage stars entirely.
Standard errors: Report in parentheses below coefficients. State clustering level in notes.
Number of observations: Report N for every regression. Report N by group for DiD/panel.
R-squared or fit measure: Report adjusted R-squared, within R-squared for FE models, or pseudo R-squared for nonlinear models.
Decimal places: 2-3 significant digits. Do not report 8 decimal places from Stata/R output.
Consistent formatting: Same variable names across all tables. Same order of controls.
No vertical lines: Use horizontal rules only (booktabs style in LaTeX).
Figures
Vector format: PDF or EPS for line plots and diagrams. High-resolution PNG (300+ DPI) only for heatmaps or photos.
Readable in grayscale: Use shapes/patterns in addition to colors. At least 20% of readers print in black and white.
Axis labels: Clear, with units. Font size readable when figure is scaled to journal column width.
No chartjunk: Remove gridlines, unnecessary legends, 3D effects, excessive tick marks.
Consistent style: All figures use the same font, color palette, and line weights.
Source note: State data source and sample period below each figure.
Appendix and Online Appendix
Appendix: Proofs, additional tables referenced in the main text, variable definitions.
Online appendix: Supplementary results that support but are not essential to the main argument.
Cross-references: Every appendix item is referenced from the main text. No orphan appendix tables.
Separate file: Some journals require the online appendix as a separate PDF. Check submission guidelines.
Replication Package
Data: All data files, or clear instructions for obtaining restricted-access data.
Code: All scripts from raw data to final tables/figures. Master script that runs everything in order.
Tested: Run the entire pipeline from scratch on a clean machine or container.
Cover Letter
Editor name: Address to the specific editor, not "Dear Editor." Check the journal website for the handling editor or co-editors by field.
One paragraph summary: State the paper's question, method, and main result.
Contribution statement: Why this paper is a good fit for this specific journal.
Conflicts of interest: Disclose any relevant relationships.
Suggested referees: 3-5 names with affiliations and emails. Choose experts who will understand the method but are not close collaborators. Avoid suggesting people who are known to be hostile to the approach.
Excluded referees: Optional but available at most journals. Use sparingly and only for genuine conflicts.
Journal-Specific Formatting
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
The 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.
Tone and Framing
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."
What to Concede vs Defend
Concede when:
The referee is factually correct about an error
The suggestion improves the paper without changing the core contribution
Adding a robustness check is low-cost and reassuring
The concern is shared by multiple referees (editor will weight this heavily)
The requested analysis is standard for the method (e.g., pre-trends for DiD)
Defend when:
Conceding would undermine the paper's core identification strategy
The requested specification is econometrically inappropriate for the setting
The referee misunderstands a key aspect of the method or data
The suggestion would change the paper into a different paper entirely
Response Matrix
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.
Method-Specific Referee Concerns
For per-method concern tables (IV, DiD, Structural Estimation, RDD, Matching), including typical phrasing and detailed response strategies, see: references/referee-tactics.md
Revision Management
Track Changes Workflow
# 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.
Multi-Round Revision Strategy
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.
Editor Communication
Decision Types
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.
When to Contact the Editor
Before submission: Only if you have a genuine question about scope or formatting not answered by the guidelines.
During review: Do not ask about status before the stated expected turnaround (usually 3-6 months). A brief polite inquiry is acceptable after.
After R&R: Contact before deadline if you need an extension.
After rejection: Only if the referee made a demonstrable factual error. "I disagree" is not grounds for appeal.
Submission Timing
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.
Pre-Print and Archive Workflows
arXiv Submission
Create a flat submission folder with: paper.tex, paper.bbl (compiled bibliography), all figures as PDF
Adjust preamble: remove \usepackage{hyperref} if it causes issues, ensure \graphicspath is relative
Remove or inline any custom .sty files
Zip and upload to arxiv.org; select econ category (econ.EM for econometrics, econ.GN for general)
Working Paper Distribution
SSRN: Post before journal submission — journals expect papers to circulate as working papers first
NBER/CEPR: If affiliated, submit to the relevant working paper series
RePEc: Register at ideas.repec.org/stepbystep.html for archival and citation tracking
Quarto to Journal Format
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.
