Research rebuttal
Draft venue-aware academic rebuttals and author responses from reviewer comments, scores, and paper artifacts. Use when concrete reviewer comments already exist and Codex needs to analyze reviews, build a reviewer issue board, plan evidence or manuscript fixes, draft a rebuttal, respond to AC or meta-review feedback, manage multi-round author-reviewer discussion, or prepare a paste-ready response for conference or journal review systems. Prefer `research-paper-review` for initial manuscript diagnosis before reviews arrive, `research-review-loop` for internal tracked review without external reviewer comments, and `research-novelty-review` for prior-art positioning disputes.From its SKILL.md
npx -y skills add kenantang/codex-and-claude-skills --skill research-rebuttalAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
10.3 KB, ~2.1k tokens by cl100k_base, as published. Nobody here has run it
Research Rebuttal
Quick start
- Decide whether this stays standalone or becomes
./rebuttal/inside an orchestrated research suite. - Route the venue first with
references/venue_rule_matrix.md; if dates, limits, or policy details are decision-critical, re-check the official venue source before finalizing. - Initialize the rebuttal pack with
scripts/init_rebuttal_pack.pyunless usable artifacts already exist. - Build the review analysis and issue board before drafting prose.
- Convert major issues into concrete evidence or manuscript tasks, then draft the correct artifact shape and verify limits with
scripts/count_limits.sh.
Modes
Standalone mode
- Work from pasted reviews, PDFs, screenshots, or local notes.
- Do not require a suite root.
- Remain collaboration-friendly: if
research-paper-plan,research-review-loop, experiment outputs, or manuscript diffs already exist, use them.
Orchestrated mode
- Prefer the canonical directory
./rebuttal/. - Read upstream context from
research-brief.md,artifact-index.md,./paper-plan/,./review-loop/, and relevant result artifacts when present. - Keep outputs legible to later manuscript revision, camera-ready planning, or follow-up review rounds.
Relationship to sibling skills
research-paper-reviewshould usually happen before rebuttal if the paper still needs a first-pass technical diagnosis.research-review-loopshould track internal revision rounds and issue closure between rebuttal iterations.research-rebuttalstarts when there are concrete reviewer comments and a venue-specific response artifact to produce.research-novelty-reviewis a helper when the central dispute is novelty or prior-art overlap rather than general reviewer response.
Handling review inputs
- Pasted text: use directly, but check whether the paste is complete.
- PDF review bundles: extract all review text, scores, and confidence values before analysis.
- Screenshots: transcribe visible review content and flag truncation or unreadable regions.
- OpenReview or CMT links: treat raw platform access as unreliable; ask for pasted review text if needed.
- Paper PDF or source: read as needed to cross-reference challenged claims, tables, or sections.
- If review metadata is incomplete, proceed conservatively and label the missing fields rather than inventing them.
Input contract
- Minimum:
- concrete reviewer feedback or review text
- target venue or best-known venue family
- Prefer:
- scores and confidence values
- paper PDF, source, or exact section references
- existing experimental logs, tables, or manuscript diffs
- deadline and artifact constraints
Hard stops
- Stop if there is no concrete review text or reviewer feedback artifact.
- Stop if the venue materially changes the artifact but cannot be inferred well enough to pick a conservative route.
- Stop if the draft would require invented evidence, fabricated experiments, or unverified manuscript changes.
- In standalone mode, do not force a scaffold pack when a compact direct response is enough.
Output contract
- Primary files:
review-analysis.mdissue-board.mdtask-list.mdrebuttal-working.mdrebuttal-paste-ready.md
- Optional file:
ac-note.md
- In orchestrated mode, these live under
./rebuttal/. - The working draft may contain
[INTERNAL]notes; the paste-ready draft must not.
Workflow
1) Route venue and policy constraints first
- Use
references/venue_rule_matrix.mdto choose the artifact structure:- one-shot PDF
- per-review response
- threaded discussion
- rolling revision response
- single-feedback response
- Use
references/platforms_and_policies.mdfor platform mechanics, anonymity, disclosure, link, revision, and LLM-policy checks. - If venue information is incomplete, state the assumption and choose the most conservative valid route.
- Treat dated limits, windows, and policy details as unstable. Re-check official venue sources before final submission when those details matter.
2) Analyze reviews and build the issue board
- Summarize each reviewer's decision logic, score, confidence, and likely AC-facing concern in
review-analysis.md. - Build
issue-board.mdusingreferences/issue_board_guide.md. - Extract a score matrix first. As a default heuristic, treat reviewers as:
- Champion: strong accept signal or clearly positive language
- Persuadable: mixed review or borderline score
- Entrenched: strongly negative decision logic unlikely to flip
- Spend most rebuttal budget on Persuadable reviewers and committee-facing concerns, while maintaining Champion support.
- Group shared concerns across reviewers and mark severity aggressively:
- Major-Blocking
- Major-Addressable
- Minor
- Misunderstanding
- Classify reviewer stance as Champion, Persuadable, or Entrenched using
references/writing_principles.md. - Use an explicit issue-board shape rather than free-form notes. For example:
issue_id | reviewer | severity | category | strategy | status | shared_with
R1-1 | R1 | Major-Blocking | baselines | TBD | open |
R2-1 | R2 | Misunderstanding | novelty | TBD | open |
R3-1 | R3 | Major-Addressable | ablations | TBD | open | R1-1
- If the user asked only for triage or analysis, stop after the analysis and issue board.
3) Choose response strategies per issue
- Use
references/response_strategies.md. - Prefer one or more of:
- Accept and fix
- Clarify misunderstanding
- Partial agree and narrow claim
- Respectful disagreement
- Out of scope
- Escalate to AC
- Strategy choice must depend on factual correctness, acceptance impact, and venue policy constraints, not rhetorical preference.
- Compound strategies are often correct:
- clarify misunderstanding + accept a presentation fix
- accept and fix + provide new evidence
- partial agree + narrow the claim
- Do not promise evidence you do not have. Missing evidence becomes a task, not a rhetorical flourish.
4) Convert strategy into an execution plan
- Fill
task-list.mdwith owner if known, required input, evidence source, whether the task blocks drafting, and whether it changes the manuscript, rebuttal, or both. - Prefer real evidence over promises. If evidence is missing, turn the gap into an explicit task rather than bluffing.
- Pull in upstream research artifacts when available:
research-paper-planfor claim and section mappingsresearch-review-loopfor tracked issues across rounds- experiment or results artifacts for numbers and provenance
5) Draft the correct artifact
- Draft
rebuttal-working.mdfirst, then strip it down intorebuttal-paste-ready.md. - Match the venue family:
- one-shot PDF venues: merge repeated concerns and lead with the few issues most likely to affect the decision
- per-review venues: keep replies self-contained
- threaded venues: optimize for concise follow-ups and delta replies
- rolling venues: emphasize revision plan over argument
- Use direct answer -> evidence -> implication structure.
- Keep every response self-contained enough that the reviewer or AC can scan it without hunting through the manuscript.
- For venues with strict character budgets, allocate rough space before writing:
- opener or global summary: 10-15%
- per-reviewer core responses: 75-80%
- closing or summary of changes: 5-10%
- Use the working draft as the evidence-rich version and the paste-ready draft as the platform-safe compressed artifact.
- Example of a good response shape:
[R2] Missing comparison to MethodX
Direct answer: We agree this comparison is decision-relevant and have now run it.
Evidence: Table 2 below shows +2.1 points over MethodX on Dataset A.
Implication: This resolves the concern that our gains came only from benchmark selection.
- Avoid defensive responses such as:
- "the reviewer failed to notice"
- "it is obvious"
- "we will fix this in the camera-ready" without evidence or a venue-legal commitment
6) Run mandatory safety gates
- Provenance gate:
- every number, experimental result, section reference, and manuscript change must trace to a real source
- Commitment gate:
- do not claim a manuscript change or experiment unless it already exists or is explicitly labeled as planned
- Coverage gate:
- every Major-Blocking and Major-Addressable issue must be closed, deferred with justification, or explicitly accepted as a risk
- Verify size limits with
scripts/count_limits.sh <file> [--chars|--words|--pages] [--limit N]. - If
paper-review/final_issues.jsonorreview-loop/REVIEW_STATE.jsonexists, cross-check that the rebuttal does not quietly contradict the internal diagnosis.
7) Handle follow-up rounds carefully
- Update the issue board rather than rewriting the whole response from scratch.
- Reply only to new or still-open points.
- Increase technical specificity, not argumentative intensity.
- If a disagreement persists after repeated rounds, summarize the positions cleanly and let the committee adjudicate.
- In multi-round venues, treat the issue board as the source of truth and write delta replies only.
Scripts
scripts/init_rebuttal_pack.py: create deterministic rebuttal scaffolds in a standalone directory or./rebuttal/.scripts/count_limits.sh: measure chars, words, or rough page equivalents after stripping common markup.
References
references/issue_board_guide.mdreferences/platforms_and_policies.mdreferences/response_strategies.mdreferences/venue_rule_matrix.mdreferences/writing_principles.md../research-pipeline-planner/references/review-stage-contract.md
What ships with it: 8 files
45.5 KB alongside SKILL.md, 2 of them executable
agents/
- openai.yaml297 B
references/
- issue_board_guide.md5.1 KB
- platforms_and_policies.md3.1 KB
- response_strategies.md10.4 KB
- venue_rule_matrix.md14.4 KB
- writing_principles.md7.2 KB
scripts/
- count_limits.shruns2.2 KB
- init_rebuttal_pack.pyruns2.8 KB