Agent skill

Comments Synthesis

by franklee16 in franklee16/academic-research-skills

Consolidate feedback from multiple discussants, referees, and commentators on a research paper into one unified revision plan.

No licenceAuto-check passedDocuments & Office

Install Comments Synthesis

skills CLI
$ npx skills add franklee16/academic-research-skills --skill comments-synthesis -a claude-code

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

GitHub CLI
$ gh skill install franklee16/academic-research-skills comments-synthesis --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/franklee16/academic-research-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/review-revise/comment-synthesis .claude/skills/comments-synthesis && 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
comments-synthesis
GitHub stars
223
Token cost
~2.7k tokens
SKILL.md length
1,232 words
Files
2 (incl. scripts)
Skills in repo
1,616
Repo updated
First seen
Licence
None found

At a glance

Consolidate feedback from multiple discussants, referees, and commentators on a research paper into one unified revision plan.

  • Works in 7 steps: Inventory the sources → Extract the substantive comments from… → Cluster thematically and count convergence → …
  • The user says they got discussant comments at a conference
  • SKILL.md covers What this skill does, When to use, Inputs and Workflow, plus 4 more sections
  • Runs Python scripts from its folder; calls python

What it does

Comments Synthesis is an agent skill from franklee16/academic-research-skills. Consolidate feedback from multiple discussants, referees, and commentators on a research paper into one unified revision plan. Use this skill WHENERVER a user has gathered comments, discussion decks, referee reports, or reviewer feedback from more than one source on a paper and wants them synthesized — for example "synthesize the comments", "consolidate the discussant feedback", "what are the common comments across referees", "build a revision plan from the discussion decks", "combine the discussant comments"…

Its SKILL.md is about 2.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/extract_sources.py`).

It sits in Documents & Office, covering Word documents and PowerPoint presentations. It works with Microsoft PowerPoint and Microsoft Word. The repository describes itself as: Comprehensive collection of Claude Code skills for academic research in economics, finance, and social sciences.

When your agent uses it

  • The user says they got discussant comments at a conference
  • An R&R with referee reports
  • Workshop feedback and wants it pulled together
  • A single comment

Example prompts

  • “synthesize the comments”
  • “consolidate the discussant feedback”
  • “what are the common comments across referees”
  • “/comments-synthesis”

Requirements

  • Python 3

Workflow steps

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

  1. Inventory the sources
  2. Extract the substantive comments from each source
  3. Cluster thematically and count convergence
  4. Write each comment entry
  5. Build the prioritized roadmap
  6. Write the report
  7. Cleanup (ask first)

What it can do on your machine

Read from SKILL.md and the folder at commit 9a4b2db. 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

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    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

Comments Synthesis loads about 2.7k tokens when it runs. Until then it costs about 241 tokens; SKILL.md has 1,232 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~241
When it runs · the whole SKILL.md, loaded when a task matches
~2.7k

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); the scripts in this folder are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 1,232 words (~2,708 tokens).

“A paper usually collects feedback from several independent readers — conference discussants, journal referees, workshop attendees, co-authors. Each speaks from a different angle, but the same handful of concerns recur. The value of synthesizing them is convergence detection: an issue…”

— opening of SKILL.md by franklee16
name
comments-synthesis

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file (scripts) in review-revise/comment-synthesis of franklee16/academic-research-skills.

  • SKILL.md
  • scripts/extract_sources.py

Open the folder on GitHubat commit 9a4b2db

Compare with similar skills

Comments Synthesis 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.

Comments Synthesis compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Comments Synthesis this skillfranklee16/academic-research-skills223—~2.7kAutomated safety check: PassNone
MarkitdownImCa0/just-laws78114 repos~3.2kAutomated safety check: NotesMIT
GenOffice Document CLIgenspark-ai/genoffice8.9k—~19kAutomated safety check: PassApache-2.0
Docx4jplutext/docx4j2.4k—~2.5kAutomated safety check: PassNone
Cyber Pptcrazyykhllc-bit/CyberPPT1.8k—~10kAutomated safety check: PassMIT
Docsagentdocsagent/docsagent625—~834Automated safety check: PassNone

Similar skills

  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    781 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • GenOffice Document CLI

    genspark-ai/genoffice

    Creates, converts, reads and edits real pptx, xlsx, docx and PDF files locally through the genoffice command line.

    8.9k GitHub stars~19k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Docx4j

    plutext/docx4j

    A skill your agent uses when writing Java code that creates, reads or edits Word (.docx), PowerPoint (.pptx) or Excel (.xlsx) files with docx4j — including generating documents, editing existing…

    2.4k GitHub stars~2.5k tokensUpdated yesterday
    Documents & OfficeAuto-check passed
  • Cyber Ppt

    crazyykhllc-bit/CyberPPT

    当用户需要把 DOCX、PDF、TXT、XLSX、研究报告、业务材料或原始数据转成高密度、可编辑、咨询风格 PPTX 时使用;也适用于需要 SCR 论证、视觉风格探索、详细图表和渲染质检的 PPT。

    1.8k GitHub stars~10k tokensUpdated 2 mo ago
    Documents & OfficeAuto-check passed
  • Docsagent

    docsagent/docsagent

    Search and manage private, local document collections (PDF, PPTX, DOCX) offline.

    625 GitHub stars~834 tokensUpdated 10 days ago
    Documents & OfficeAuto-check passed
  • Markit

    shift-labs-ai/markit

    Convert files and URLs to Markdown. An agent skill from shift-labs-ai/markit.

    1.3k GitHub stars~299 tokensUpdated 1 mo ago
    Documents & OfficeAuto-check passed

More from franklee16/academic-research-skills

All 1,616 skills in this repo
  • Econometric Research Writing

    franklee16/academic-research-skills

    End-to-end econometric analysis and economics/management paper-writing workflow.

    223 GitHub stars~2.4k tokensUpdated 20 days ago
    Auto-check passed
  • Paper Revision

    franklee16/academic-research-skills

    Comprehensive workflow for handling journal Revise and Resubmit (R&R) decisions.

    223 GitHub stars~3.4k tokensUpdated 20 days ago
    Auto-check passed
  • Sci Ssci Polishing

    franklee16/academic-research-skills

    A skill your agent uses when researchers need Chinese academic prose translated into publication-oriented English or English manuscript paragraphs and complete sections polished for SCI, SSCI, or…

    223 GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed
  • Research Defense Radar

    franklee16/academic-research-skills

    Assess and monitor an ongoing research project's competitor landscape, novelty risk, and method/data opportunities from a proposal, paper, research question, data or method notes, or a suspected…

    223 GitHub stars~4k tokensUpdated 20 days ago
    Auto-check passed
  • Academic Grant

    franklee16/academic-research-skills

    Generate or fill in academic grant application forms (project statement, education plan, pathway to impact, references) using draft research material.

    223 GitHub stars~2.8k tokensUpdated 20 days ago
    Auto-check: notes
  • Chinese Reference Formatter Skill

    franklee16/academic-research-skills

    A skill your agent uses when a user needs通用中文参考文献、GB/T 7714-style bibliography entries, Chinese academic reference formatting, or BibTeX completion from Chinese or English literature titles…

    223 GitHub stars~1.1k tokensUpdated 20 days ago
    Auto-check passed

Questions about Comments Synthesis

What does Comments Synthesis do?

Consolidate feedback from multiple discussants, referees, and commentators on a research paper into one unified revision plan. Comments Synthesis is an agent skill from franklee16/academic-research-skills. Consolidate feedback from multiple discussants, referees, and commentators on a research paper into one unified revision plan.

When should I use Comments Synthesis?

Comments Synthesis fits situations like: the user says they got discussant comments at a conference; an R&R with referee reports; workshop feedback and wants it pulled together; A single comment.

How do I install Comments Synthesis in Claude Code?

Run `npx skills add franklee16/academic-research-skills --skill comments-synthesis -a claude-code`. Or copy the skill folder (review-revise/comment-synthesis in franklee16/academic-research-skills) into .claude/skills/comments-synthesis in your project. Claude Code loads it when a task matches its description.

How do I install Comments Synthesis in Codex?

Run `npx skills add franklee16/academic-research-skills --skill comments-synthesis -a codex`. Or copy the skill folder (review-revise/comment-synthesis in franklee16/academic-research-skills) into .agents/skills/comments-synthesis in your project. Codex loads it when a task matches its description.

Can I use Comments Synthesis 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 franklee16/academic-research-skills --skill comments-synthesis -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/comments-synthesis, .gemini/skills/comments-synthesis, .github/skills/comments-synthesis and .opencode/skills/comments-synthesis in your project.

What does Comments Synthesis need to run?

Going by SKILL.md and its folder, Comments Synthesis needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Comments Synthesis 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 Comments Synthesis 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Comments Synthesis use?

No licence was found for Comments Synthesis or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Comments Synthesis use?

About 2.7k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Comments Synthesis?

Skills that share tags, products or a category with Comments Synthesis: Markitdown (ImCa0/just-laws, 781 stars), GenOffice Document CLI (genspark-ai/genoffice, 8.9k stars), Docx4j (plutext/docx4j, 2.4k stars) and Cyber Ppt (crazyykhllc-bit/CyberPPT, 1.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Comments Synthesis?

franklee16 (a GitHub user) maintains it in franklee16/academic-research-skills, which has 223 GitHub stars. The repository holds 1,616 skills in this directory. The repository was last updated on September 18, 2026.

Source: franklee16/academic-research-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.