Revision and Response to Reviewers (jacs-revision)
When to trigger
- A decision letter (major/minor revision, or reject-with-encouragement) arrived
- You need to triage referee comments into experiments vs edits vs rebuttals
- You are drafting the point-by-point response letter
- You must decide whether to appeal or to resubmit elsewhere
Triage the reports first
Sort every numbered comment into one bucket:
| Bucket |
Action |
| Data-required |
A control, extra characterization, X-ray, kinetics, or scope substrate is genuinely needed → do the experiment |
| Clarification |
A real point the text/figure can fix without new data → edit + point to the change |
| Defensible disagreement |
Reviewer is mistaken or asks beyond scope → rebut politely with evidence |
| Optional/over-reach |
Nice-to-have; address briefly or explain why out of scope |
Address the rigor-critical comments (purity, characterization, mechanism
support, reproducibility) first — these are the ones that block acceptance at JACS.
Response-letter structure
- Opening — thank the editor/reviewers; summarize the main changes and any new data/figures/SI added.
- Point by point — quote each comment, then respond. For each: state the change, where it is in the revised manuscript/SI (section, figure, page), and the new evidence.
- Quote the new text — paste added/changed passages so reviewers don't hunt.
- Rebuttals — for disagreements, be respectful and evidence-based; concede where the reviewer improves the paper.
- Marked manuscript — provide a tracked/colored version if requested.
Doing the new chemistry well
- New experiments must meet the same rigor bar: full characterization, controls,
CCDC deposition for any new structure, reproducible procedures (route to
jacs-methods).
- New compounds → add full SI entries and spectra copies (route to
jacs-supplementary).
- If a requested experiment fails or contradicts a claim, report it honestly and
adjust the claim rather than hiding it.
Tone
- Professional, specific, and complete; never dismissive even when disagreeing.
- Make the reviewer's job easy: cross-reference every change to a location.
- If a comment is based on a misreading, fix the text so the next reader can't misread it too.
JACS revision ledger
Before drafting prose, make a revision ledger that separates editor-critical chemistry from
ordinary cleanup. JACS revisions fail when a response looks complete but leaves one evidence gap
unclosed. Track each item with four fields:
| Field |
JACS-specific check |
| Claim under review |
What exact novelty, scope, mechanism, selectivity, or structure claim did the referee challenge? |
| New evidence |
Which experiment, characterization trace, spectrum, crystallographic deposit, kinetic run, or control now supports it? |
| Manuscript/SI location |
Main-text figure/table, scheme, or SI page where the reader can verify the fix without searching. |
| Claim adjustment |
Whether the language is strengthened, narrowed, or hedged because the new evidence changed the inference. |
Use the ledger to decide whether a comment is truly answered. A reviewer asking for "more evidence"
is not answered by a paragraph; it is answered by a trace, table, structure, or explicitly narrowed
claim. Conversely, a referee misunderstanding that came from ambiguous prose should produce both a
response-letter explanation and a revised sentence in the manuscript so the same misreading cannot
recur in the next round.
Checklist
Anti-patterns
- Responding "we have addressed this" without saying where or how
- Adding new compounds without adding their SI characterization
- Arguing with a referee instead of fixing the ambiguous text
- Quietly dropping an inconvenient result instead of reporting it
- Over-claiming again in the revision after softening in round one
- Ignoring a rigor request and hoping the editor overrides the referee
Output format
【Decision】major / minor / reject-with-encouragement
【Triage】data-required: [...]; clarify: [...]; rebut: [...]
【New experiments】done? characterized + deposited? Y/N
【Response letter】point-by-point complete? Y/N
【Claims adjusted】[...]
【Next】resubmit via Paragon Plus → await decision
Related resources
Source: brycewang-stanford/Awesome-Journal-Skills → Journal-of-the-American-Chemical-Society-Skills/skills/jacs-revision/SKILL.md
1---2name: jacs-revision3description: Use when a decision letter/referee reports arrive for a Journal of the American Chemical Society (JACS) manuscript, to plan experiments and draft the point-by-point response. Structures the revision and rebuttal — it does not fabricate data or guarantee acceptance.4---567# Revision and Response to Reviewers (jacs-revision)89## When to trigger1011- A decision letter (major/minor revision, or reject-with-encouragement) arrived12- You need to triage referee comments into experiments vs edits vs rebuttals13- You are drafting the point-by-point response letter14- You must decide whether to appeal or to resubmit elsewhere1516## Triage the reports first1718Sort every numbered comment into one bucket:1920| Bucket | Action |21|--------|--------|22| **Data-required** | A control, extra characterization, X-ray, kinetics, or scope substrate is genuinely needed → do the experiment |23| **Clarification** | A real point the text/figure can fix without new data → edit + point to the change |24| **Defensible disagreement** | Reviewer is mistaken or asks beyond scope → rebut politely with evidence |25| **Optional/over-reach** | Nice-to-have; address briefly or explain why out of scope |2627Address the **rigor-critical** comments (purity, characterization, mechanism28support, reproducibility) first — these are the ones that block acceptance at JACS.2930## Response-letter structure31321. **Opening** — thank the editor/reviewers; summarize the main changes and any new data/figures/SI added.332. **Point by point** — quote each comment, then respond. For each: state the change, where it is in the revised manuscript/SI (section, figure, page), and the new evidence.343. **Quote the new text** — paste added/changed passages so reviewers don't hunt.354. **Rebuttals** — for disagreements, be respectful and evidence-based; concede where the reviewer improves the paper.365. **Marked manuscript** — provide a tracked/colored version if requested.3738## Doing the new chemistry well3940- New experiments must meet the same rigor bar: full characterization, controls,41 CCDC deposition for any new structure, reproducible procedures (route to `jacs-methods`).42- New compounds → add full SI entries and spectra copies (route to `jacs-supplementary`).43- If a requested experiment fails or contradicts a claim, report it honestly and44 adjust the claim rather than hiding it.4546## Tone4748- Professional, specific, and complete; never dismissive even when disagreeing.49- Make the reviewer's job easy: cross-reference every change to a location.50- If a comment is based on a misreading, fix the text so the next reader can't misread it too.5152## JACS revision ledger5354Before drafting prose, make a revision ledger that separates **editor-critical chemistry** from55ordinary cleanup. JACS revisions fail when a response looks complete but leaves one evidence gap56unclosed. Track each item with four fields:5758| Field | JACS-specific check |59|-------|---------------------|60| Claim under review | What exact novelty, scope, mechanism, selectivity, or structure claim did the referee challenge? |61| New evidence | Which experiment, characterization trace, spectrum, crystallographic deposit, kinetic run, or control now supports it? |62| Manuscript/SI location | Main-text figure/table, scheme, or SI page where the reader can verify the fix without searching. |63| Claim adjustment | Whether the language is strengthened, narrowed, or hedged because the new evidence changed the inference. |6465Use the ledger to decide whether a comment is truly answered. A reviewer asking for "more evidence"66is not answered by a paragraph; it is answered by a trace, table, structure, or explicitly narrowed67claim. Conversely, a referee misunderstanding that came from ambiguous prose should produce both a68response-letter explanation and a revised sentence in the manuscript so the same misreading cannot69recur in the next round.7071## Checklist7273- [ ] Every numbered comment has a response — none skipped74- [ ] Rigor-critical comments addressed with real data, not words75- [ ] New compounds/structures fully characterized and deposited (CCDC)76- [ ] Each response cites the exact location of the change77- [ ] Added/changed text quoted in the letter78- [ ] Disagreements rebutted with evidence and courtesy79- [ ] Claims softened or revised where new data require it80- [ ] Marked-up manuscript prepared if requested8182## Anti-patterns8384- Responding "we have addressed this" without saying where or how85- Adding new compounds without adding their SI characterization86- Arguing with a referee instead of fixing the ambiguous text87- Quietly dropping an inconvenient result instead of reporting it88- Over-claiming again in the revision after softening in round one89- Ignoring a rigor request and hoping the editor overrides the referee9091## Output format9293```94【Decision】major / minor / reject-with-encouragement95【Triage】data-required: [...]; clarify: [...]; rebut: [...]96【New experiments】done? characterized + deposited? Y/N97【Response letter】point-by-point complete? Y/N98【Claims adjusted】[...]99【Next】resubmit via Paragon Plus → await decision100```101102## Related resources103104- [`jacs-methods`](../jacs-methods/SKILL.md) — rigor bar for new experiments105- [`jacs-supplementary`](../jacs-supplementary/SKILL.md) — adding SI for new compounds106- [`jacs-referee-strategy`](../jacs-referee-strategy/SKILL.md) — anticipated objections to map onto the actual reports107108---109110**Source:** [`brycewang-stanford/Awesome-Journal-Skills`](https://github.com/brycewang-stanford/Awesome-Journal-Skills) → `Journal-of-the-American-Chemical-Society-Skills/skills/jacs-revision/SKILL.md`
thedixitjain