Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add franklee16/academic-research-skills --skill comments-synthesis -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/comment-synthesis/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/comment-synthesis/

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.

Similar skills

All skills for Science and research →

From the same set98

The whole set →
dril-dataset-construction dril-dataset-construction implements the DRIL methodology to assemble economic datasets from primary sources via AI agents. Ideal for constructing panel data, legal variables, and cited codebooks. CX Codex +1 ★ 240repo stars extract-figures extract-figures pulls figures, charts, diagrams, and images from .docx, converts EMF/WMF assets to PNG, and prepares LaTeX usage notes. CX Codex +1 ★ 240repo stars aer-referee-sim aer-referee-sim runs a finished manuscript through a mock AER desk screen and three referees, then returns a verdict and a prioritized revise list. CX Codex +1 ★ 240repo stars practitioner-finance-voice The practitioner-finance-voice skill rewrites academic finance drafts into the direct tone of practitioner outlets like FAJ and JPM. It frames findings for portfolio managers without fabricating facts. CX Codex +1 ★ 240repo stars nature-figure nature-figure structures high-impact publication figure design using Python or R backends. CX Codex +1 ★ 240repo stars llm-replication-disclosure llm-replication-disclosure is a Claude Code skill that checks replication materials for LLM-assisted research and helps draft disclosure text before submission or a data-editor response. CX Codex +1 ★ 240repo stars aer-replication aer-replication builds a replication package for AEA journals under the February 2026 Data and Code Availability Policy. Checks the README and folder layout before the AEA Data Editor review. CX Codex +1 ★ 240repo stars academic-grant Transforms research paper drafts and empirical results into completed academic grant application forms using coordinated agents. CX Codex +1 ★ 240repo stars

Project sponsors

Companies that keep this analytics open