Agent skill

Rebuttal Guidance

by HKUSTDial in HKUSTDial/Supervisor-Skills

Turns pasted peer-review comments into a per-concern rebuttal plan, with reviewer mindset matching and strategy priorities, but not the final rebuttal text.

Custom licenceAuto-check passedResearch & Science

Install Rebuttal Guidance

skills CLI
$ npx skills add HKUSTDial/Supervisor-Skills --skill rebuttal-guidance -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install HKUSTDial/Supervisor-Skills rebuttal-guidance --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/HKUSTDial/Supervisor-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/rebuttal-guidance .claude/skills/rebuttal-guidance && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
rebuttal-guidance
GitHub stars
8.8k
Token cost
~1.3k tokens
SKILL.md length
476 words
Files
7 (incl. references)
Skills in repo
12
Repo updated
First seen
Licence
Custom licence

At a glance

Turns pasted peer-review comments into a per-concern rebuttal plan, with reviewer mindset matching and strategy priorities, but not the final rebuttal text.

  • Works in 7 steps: Inventory concerns → Classify each concern → Match reviewer mindset (X) → …
  • Pasting reviewer comments from a conference review and needing a response plan
  • SKILL.md covers Overview, When to use, When NOT to use and Core procedure, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

The skill delivers executable guidance for each reviewer concern: structured plans, evidence pointers and tone and strategy priorities. It does not write paste-ready rebuttal prose, and the author writes the final text. Its model is conditional persuasion: the reviewer's mindset, the rebuttal strategy chosen and the outcome, a score increase or acceptance.

The procedure inventories every numbered weakness and question in a table, asking whether other reviewers exist, then tags each as a misunderstanding, evidence gap, novelty, baseline fairness, scope claim, writing clarity, theory, efficiency or other concern. It scores the review on five to seven behavior signals, such as openness, severity, skepticism and actionability, maps them to a reviewer cluster with a stated confidence and the phrases that triggered the match, and reads that cluster's strategy priorities and historical up-rate. The excerpt is cut off at that point.

It is for conference reviews such as ICLR, NeurIPS, ICML and EMNLP, and for cases where a reviewer ignored a rebuttal. Requests to evaluate a research idea or review a paper before submission go to other skills, and the agent asks for the review text if none was given. Reference files cover a checklist, concern classification, a mindset library, matching heuristics, response templates and strategy dimensions.

When your agent uses it

  • Pasting reviewer comments from a conference review and needing a response plan
  • Deciding how to reply to one specific reviewer weakness
  • Recalibrating after a reviewer ignored your rebuttal
  • Choosing a tone and evidence strategy for a harsh versus an open reviewer

Example prompts

  • “Here are the reviews from OpenReview. Give me a rebuttal plan for each weakness.”
  • “How should I reply to R1.W2? The reviewer says our baselines are unfair.”
  • “The reviewer ignored my rebuttal. What should I do in the follow-up?”

Requirements

  • The reviewers' weaknesses and questions pasted into the chat

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Inventory concerns
  2. Classify each concern
  3. Match reviewer mindset (X)
  4. Strategy priorities for this mindset (Y)
  5. Per-concern guidance
  6. Integrity gate
  7. Output format

What it can do on your machine

Read from SKILL.md and the folder at commit 207bc6f. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Rebuttal Guidance loads about 1.3k tokens when it runs, and up to ~8.6k if it reads all its reference files. Until then it costs about 118 tokens; SKILL.md has 476 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~118
When it runs · the whole SKILL.md, loaded when a task matches
~1.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~8.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 476 words (~1,322 tokens).

“This skill delivers executable rebuttal guidance per concern: structured plans, evidence pointers, tone and strategy priorities. It does not produce ready-to-paste rebuttal prose; the author writes the final text.”

— opening of SKILL.md by HKUSTDial, Custom licence
name
rebuttal-guidance

Read the full SKILL.md on GitHub

Files

SKILL.md and 6 other files (references) in skills/rebuttal-guidance of HKUSTDial/Supervisor-Skills.

  • SKILL.md
  • references/checklist.md
  • references/concern-classification.md
  • references/mindset-library.md
  • references/mindset-matching-heuristics.md
  • references/response-templates.md
  • references/strategy-dimensions.md

Open the folder on GitHubat commit 207bc6f

Compare with similar skills

Rebuttal Guidance next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Rebuttal Guidance compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Rebuttal Guidance this skillHKUSTDial/Supervisor-Skills8.8k—~1.3kAutomated safety check: PassCustom licence
Academic Paper Writing PipelineImbad0202/academic-research-skills51k—~16kAutomated safety check: PassCustom licence
Academic Paper ReviewerImbad0202/academic-research-skills51k—~11kAutomated safety check: PassCustom licence
Academic Research PipelineImbad0202/academic-research-skills51k—~15kAutomated safety check: PassCustom licence
Academic Research Suite for CodexImbad0202/academic-research-skills-codex12k—~12kAutomated safety check: PassCustom licence
Manuscript Statistics AuditYuan1z0825/nature-skills47k2 repos~2.1kAutomated safety check: PassApache-2.0

Similar skills

  • Academic Paper Writing Pipeline

    Imbad0202/academic-research-skills

    Runs a 12-agent pipeline that plans, drafts, cites, reviews and formats academic papers, with modes for revision, rebuttals, abstracts and citation checks.

    51k GitHub stars~16k tokensUpdated yesterday
    Research & ScienceAuto-check passed
  • Academic Paper Reviewer

    Imbad0202/academic-research-skills

    Simulates a journal peer review of a manuscript with a five-seat reviewer panel, an editorial synthesizer and several review modes.

    51k GitHub stars~11k tokensUpdated yesterday
    Research & ScienceAuto-check passed
  • Academic Research Pipeline

    Imbad0202/academic-research-skills

    Orchestrates a ten-stage academic workflow from research to finished manuscript, including integrity checks, two rounds of peer review and revision.

    51k GitHub stars~15k tokensUpdated yesterday
    Research & ScienceAuto-check passed
  • Academic Research Suite for Codex

    Imbad0202/academic-research-skills-codex

    A router skill that sends academic work such as literature reviews, drafting, citation checks, peer review and revision to the right workflow in the ARS suite.

    12k GitHub stars~12k tokensUpdated 7 days ago
    Research & ScienceAuto-check passed
  • Manuscript Statistics Audit

    Yuan1z0825/nature-skills

    Audits or rewrites the statistical reporting in a manuscript: experimental units, replication, tests, uncertainty and figure legends, without inventing missing details.

    47k GitHub starsUsed in 2 repos~2.1k tokens
    Research & ScienceAuto-check passed
  • Social Science Paper Writing

    fakerqwq/social-science-paper-writing-skill

    Helps draft, diagnose, review and revise social science papers, from topic and research question to literature review, citation risks and pre-submission checks.

    382 GitHub stars~7k tokensUpdated 4 mo ago
    Research & ScienceAuto-check passed

More from HKUSTDial/Supervisor-Skills

All 12 skills in this repo
  • Benchmark Paper Template

    HKUSTDial/Supervisor-Skills

    Structures benchmark and evaluation papers around five pillars, with a completeness audit, an Introduction logic chain, a section skeleton and a pre-submission checklist.

    8.8k GitHub stars~2.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Draw.io Diagram Reconstruction

    HKUSTDial/Supervisor-Skills

    Rebuilds a reference diagram image as an editable, high-fidelity Draw.io file, mixing native elements, SVG icons and cropped PNGs, with a batch workflow for a folder of images.

    8.8k GitHub stars~5.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Paper Introduction Drafter

    HKUSTDial/Supervisor-Skills

    Drafts the Introduction of a technical paper as six paragraphs of flowing prose, positioning the work and matching contributions to challenges, with an outline on request.

    8.8k GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Deep Research Literature Survey

    HKUSTDial/Supervisor-Skills

    Runs a survey-grade literature investigation: fixes the research questions, searches from adversarial angles, verifies citations and writes an evidence-first report.

    8.8k GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Paper Figure Designer

    HKUSTDial/Supervisor-Skills

    Advises on designing the three core figures of a technical paper, then audits them against rules for format, fonts, color and captions.

    8.8k GitHub stars~1.9k tokensUpdated 1 mo ago
    Auto-check passed
  • Research Idea Evaluator

    HKUSTDial/Supervisor-Skills

    Evaluates a draft research idea like a top-venue reviewer and advisor, scoring it on five dimensions, checking fit with your capacity and returning a clear verdict.

    8.8k GitHub stars~3.4k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Rebuttal Guidance

What does Rebuttal Guidance do?

Turns pasted peer-review comments into a per-concern rebuttal plan, with reviewer mindset matching and strategy priorities, but not the final rebuttal text. The skill delivers executable guidance for each reviewer concern: structured plans, evidence pointers and tone and strategy priorities. It does not write paste-ready rebuttal prose, and the author writes the final text.

When should I use Rebuttal Guidance?

Rebuttal Guidance fits situations like: pasting reviewer comments from a conference review and needing a response plan; deciding how to reply to one specific reviewer weakness; recalibrating after a reviewer ignored your rebuttal; choosing a tone and evidence strategy for a harsh versus an open reviewer.

How do I install Rebuttal Guidance in Claude Code?

Run `npx skills add HKUSTDial/Supervisor-Skills --skill rebuttal-guidance -a claude-code`. Or copy the skill folder (skills/rebuttal-guidance in HKUSTDial/Supervisor-Skills) into .claude/skills/rebuttal-guidance in your project. Claude Code loads it when a task matches its description.

How do I install Rebuttal Guidance in Codex?

Run `npx skills add HKUSTDial/Supervisor-Skills --skill rebuttal-guidance -a codex`. Or copy the skill folder (skills/rebuttal-guidance in HKUSTDial/Supervisor-Skills) into .agents/skills/rebuttal-guidance in your project. Codex loads it when a task matches its description.

Can I use Rebuttal Guidance in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add HKUSTDial/Supervisor-Skills --skill rebuttal-guidance -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/rebuttal-guidance, .gemini/skills/rebuttal-guidance, .github/skills/rebuttal-guidance and .opencode/skills/rebuttal-guidance in your project.

What does Rebuttal Guidance need to run?

SKILL.md names no scripts, command-line tools or credentials: Rebuttal Guidance is instructions for the agent only. Our summary lists: The reviewers' weaknesses and questions pasted into the chat.

Does Rebuttal Guidance access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Rebuttal Guidance safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Rebuttal Guidance use?

Rebuttal Guidance has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Rebuttal Guidance use?

About 1.3k tokens (SKILL.md is roughly 5.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 7.3k tokens, read only when the agent opens those files.

What are the alternatives to Rebuttal Guidance?

Skills that share tags, products or a category with Rebuttal Guidance: Academic Paper Writing Pipeline (Imbad0202/academic-research-skills, 51k stars), Academic Paper Reviewer (Imbad0202/academic-research-skills, 51k stars), Academic Research Pipeline (Imbad0202/academic-research-skills, 51k stars) and Academic Research Suite for Codex (Imbad0202/academic-research-skills-codex, 12k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Rebuttal Guidance?

HKUSTDial (a GitHub organization) maintains it in HKUSTDial/Supervisor-Skills, which has 8,783 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on September 5, 2026.

Source: HKUSTDial/Supervisor-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.