From ai4ss-skills
Guides revision of political-science manuscripts in response to peer review. Use for R&R work, response memos, and evidence-based disagreement.
How this skill is triggered — by the user, by Claude, or both
Slash command
/ai4ss-skills:reviewer-responseThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Treat peer review as a further round of research. Reconstruct the strongest concern in each report,
Treat peer review as a further round of research. Reconstruct the strongest concern in each report, revise the study where the criticism is valid, and explain disagreements with evidence and explicit reasoning.
The revision should leave:
A compact tracking table may help with a long R&R, but it is optional and should not replace the memo.
Read the editor letter, every report, the manuscript, appendices, tables, figures, prior correspondence, and available research materials. Preserve reviewer numbering for reference, but understand the paper and the editor's decision before decomposing comments.
Treat confidential materials according to their stated access conditions.
Distinguish the literal request from the underlying problem. A request for another robustness test may reflect distrust of the comparison; a request for more literature may reflect an unclear contribution; a “writing” complaint may reveal that the theory does not cohere. State the strongest charitable version of the concern.
Identify the few comments that determine whether the paper can succeed. Reconcile conflicting reviewer requests by protecting or revising the paper's central point, not by adding everything. Decide whether a concern requires substantive research, clarification, narrower claims, restructuring, or evidence-based disagreement.
Where the available materials permit, revise the argument, measures, design explanation, interpretation, tables, figures, or working prose. Inspect new analyses before relying on them. A sentence or paragraph addition does not answer a theoretical, measurement, or identification problem unless it genuinely changes the reader's understanding.
When a requested analysis or new source is not yet available, specify the exact research work and what outcome would count as resolving the concern. Do not claim that work was completed when no evidence exists.
Disagree when the request is infeasible, contradicts the paper's inquiry, rests on a factual or methodological mistake, conflicts with stronger evidence, or would break the design. Acknowledge the underlying concern, explain the reasoning, support it with evidence, and offer a narrower clarification or alternative analysis when useful. Never dismiss a misunderstanding without considering whether the manuscript caused it.
For each important point:
Keep the tone calm, direct, and non-defensive. Avoid repetitive gratitude and ceremonial boilerplate.
Check that the manuscript, appendix, tables, figures, and response agree; page and section references are current; promised analyses exist; deleted claims do not survive elsewhere; and revisions have not created new contradictions. Summarize how the paper's point, theory, design, evidence, or scope changed.
Source on research practice:
The response remains a working scholarly document until the author has reconciled it with the final manuscript and submission record.
npx claudepluginhub siyaozheng/ai4ss-skills --plugin ai4ss-skillsStructures point-by-point response letters to Comparative Political Studies reviewer and editor comments for revise-and-resubmit decisions, outlining revision priorities and handling disagreements.
Structures a point-by-point response to a World Politics revise-and-resubmit, keeping the memo to ~5 pages while addressing every reviewer comment explicitly.
Drafts point-by-point rebuttal letters and revision plans for Organization Studies R&Rs, triaging theory-level, method, and reviewer-disagreement comments.