comments-synthesis — Claude Code skill: what it does, how to install
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.
no license ★ 240 updated 2026-09-18
npx skills add franklee16/academic-research-skills --skill comments-synthesis -a claude-codeWhat comments-synthesis 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.
What it helps with
- 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 for the agent
- 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
How to install comments-synthesis
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill comments-synthesis -a claude-code2Manually: put the files in place
~/.claude/skills/comment-synthesis/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/comment-synthesis/
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill comments-synthesis -a codex2Manually: put the files in place
.agents/skills/comment-synthesis/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill comments-synthesis -a cursor2Manually: put the files in place
.cursor/skills/comment-synthesis/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install franklee16/academic-research-skills review-revise/comment-synthesis/SKILL.md2Manually: put the files in place
.github/skills/comment-synthesis/SKILL.md1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill comments-synthesis -a gemini-cli2Platform CLI
gemini skills install https://github.com/franklee16/academic-research-skills --path review-revise/comment-synthesisManually: put the files in place
.devin/skills/comment-synthesis/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about comments-synthesis
How do I install comments-synthesis in Claude Code?
Run npx skills add franklee16/academic-research-skills --skill comment-synthesis -a claude-code. The skill file ends up at ~/.claude/skills/comment-synthesis/SKILL.md.
What does comments-synthesis do?
It reads every comment file for one paper, clusters the remarks by topic and counts how many sources raised each one. You get a Markdown report with shared and single-source comments plus a ranked revision roadmap.
Which file types does it read?
.pdf, .pptx, .docx, .txt and .md from the Comments/ and quality_reports/ folders. Binary files are handled by the bundled scripts/extract_sources.py.