# comments-synthesis

comments-synthesis turns feedback from several discussants, referees or workshop readers of one paper into a single revision plan, with the points they repeat ranked first.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 240 repo stars
- Author: franklee16
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/franklee16/academic-research-skills/tree/HEAD/review-revise/comment-synthesis/SKILL.md
- Updated: 2026-09-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/comments-synthesis

## What it does

Point the skill at a paper's `Comments/` or `quality_reports/` folder. It builds a table of the sources first, so the commentator, affiliation and venue sit next to each file name. Then it pulls the substantive points out of every document, keeping the tables, coefficient values and section numbers the reader cited.

Grouping happens by the issue underneath, not by wording, and each group carries a count of how many separate sources raised it. Two or more puts a comment in the shared section; a single voice keeps it in the one-off list. The report goes to `Comments/Comments_Synthesis_and_Revision_Plan.md` in three parts: shared concerns, single-reader notes, and a Must-do / Should-do / Minor roadmap ordered by repeat count and by how badly the point hurts the paper's identification.

It expects two or more independent sources, so a lone referee report is quicker to read as is. Binary decks and PDFs go through the bundled `scripts/extract_sources.py`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill comments-synthesis -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/comment-synthesis/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/comment-synthesis/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill comments-synthesis -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/comment-synthesis/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill comments-synthesis -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/comment-synthesis/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install franklee16/academic-research-skills review-revise/comment-synthesis/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/comment-synthesis/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill comments-synthesis -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/franklee16/academic-research-skills --path review-revise/comment-synthesis
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/comment-synthesis/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/franklee16/academic-research-skills/tree/HEAD/review-revise/comment-synthesis/SKILL.md

## When to use it
- merge three discussants' notes into one list
- spot the concerns two referees share
- sort fixes into must-do and minor tiers
- separate one-off remarks from repeated ones
- draft a revision plan after an R&R

## Example prompts
- Pull the discussant decks in `Comments/` into one revision plan
- Which points do the referees in `quality_reports/` agree on?
- Build a Must-do / Should-do / Minor roadmap from all the reviews

## Similar
- [academic-research-suite](https://affpapa.org/en/nevibecode/skills/academic-research-suite.md) — skill · 2200 installs
- [paper-revision](https://affpapa.org/en/nevibecode/skills/paper-revision.md) — skill · 1900 installs
- [rebuttal-writing](https://affpapa.org/en/nevibecode/skills/rebuttal-writing.md) — skill · 1700 installs
- [review-response](https://affpapa.org/en/nevibecode/skills/review-response.md) — skill · 568 installs
- [paper-review](https://affpapa.org/en/nevibecode/skills/evoscientist-paper-review.md) — skill · 530 installs
- [paper-rebuttal](https://affpapa.org/en/nevibecode/skills/paper-rebuttal.md) — skill · 457 installs

From the same set: [franklee16/academic-research-skills](https://affpapa.org/en/nevibecode/by/franklee16/academic-research-skills.md) — 98 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
