MCPInstall

research-summarizer

Structured research summarization agent skill for non-dev users. Handles academic papers, web articles, reports, and documentation. Extracts key findings, generates comparative analyses, and produces properly formatted citations. Use when: user wants to summarize a research paper, compare multiple sources, extract citations from documents, or create structured research briefs. Plugin for Claude Code, Codex, Gemini CLI, and OpenClaw.

Installs
1.2K
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/alirezarezvani/claude-skills --skill research-summarizer
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads research-summarizer automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Research Summarizer

Read less. Understand more. Cite correctly.

Structured research summarization workflow that turns dense source material into actionable briefs. Built for product managers, analysts, founders, and anyone who reads more than they should have to.

Not a generic "summarize this" — a repeatable framework that extracts what matters, compares across sources, and formats citations properly.


Scope — Distinct From the research/ Domain

This skill summarizes documents the user already has (papers, articles, reports pasted or attached). It performs no web search and needs no MCP server. It is NOT:

  • research/litreview — academic literature discovery and review-guide generation (finds papers via Consensus/academic APIs)
  • research/dossier — entity due-diligence built from live web research
  • research/notebooklm — drives Google's NotebookLM product UI
  • research/research — the router for open-ended "research [topic]" requests that require searching

If the user asks you to find sources rather than digest supplied ones, route to the research/ domain instead.


When This Skill Activates

Recognize these patterns from the user:

  • "Summarize this paper / article / report"
  • "What are the key findings in this document?"
  • "Compare these sources"
  • "Extract citations from this PDF"
  • "Give me a research brief on [topic]"
  • "Break down this whitepaper"
  • Any request involving: summarize, research brief, literature review, citation, source comparison

If the user has a document and wants structured understanding → this skill applies.


Workflow

Workflow 1 — Single Source Summary

  1. Identify source type

    • Academic paper → use IMRAD structure (Introduction, Methods, Results, Analysis, Discussion)
    • Web article → use claim-evidence-implication structure
    • Technical report → use executive summary structure
    • Documentation → use reference summary structure
  2. Scaffold the brief — python3 scripts/format_summary.py --template academic (or article/report/executive per source type), then fill in every section from the source:

    Title: [exact title]
    Author(s): [names]
    Date: [publication date]
    Source Type: [paper | article | report | documentation]
    
    ## Key Thesis
    [1-2 sentences: the central argument or finding]
    
    ## Key Findings
    1. [Finding with supporting evidence]
    2. [Finding with supporting evidence]
    3. [Finding with supporting evidence]
    
    ## Methodology
    [How they arrived at these findings — data sources, sample size, approach]
    
    ## Limitations
    - [What the source doesn't cover or gets wrong]
    
    ## Actionable Takeaways
    - [What to do with this information]
    
    ## Notable Quotes
    > "[Direct quote]" (p. X)
    
  3. Assess quality

    • Source credibility (peer-reviewed, reputable outlet, primary vs secondary)
    • Evidence strength (data-backed, anecdotal, theoretical)
    • Recency (when published, still relevant?)
    • Bias indicators (funding source, author affiliation, methodology gaps)

Workflow 2 — Multi-Source Comparison

  1. Collect sources (2-5 documents)

  2. Summarize each using the single-source workflow above

  3. Build comparison matrix

    | Dimension        | Source A        | Source B        | Source C        |
    |------------------|-----------------|-----------------|-----------------|
    | Central Thesis   | ...             | ...             | ...             |
    | Methodology      | ...             | ...             | ...             |
    | Key Finding      | ...             | ...             | ...             |
    | Sample/Scope     | ...             | ...             | ...             |
    | Credibility      | High/Med/Low    | High/Med/Low    | High/Med/Low    |
    
  4. Synthesize

    • Where do sources agree? (convergent findings = stronger signal)
    • Where do they disagree? (divergent findings = needs investigation)
    • What gaps exist across all sources?
    • What's the weight of evidence for each position?
  5. Produce synthesis brief

    ## Consensus Findings
    [What most sources agree on]
    
    ## Contested Points
    [Where sources disagree, with strongest evidence for each side]
    
    ## Gaps
    [What none of the sources address]
    
    ## Recommendation
    [Based on weight of evidence, what should the reader believe/do?]
    

Workflow 3 — Citation Extraction

  1. Run the extractor — python3 scripts/extract_citations.py document.txt --output json detects DOI/URL/author-year/numbered citations and deduplicates them
  2. Review and format the extracted list in the requested style (APA 7 default); manually catch citations the regex missed
  3. Classify citations by type:
    • Primary sources (original research, data)
    • Secondary sources (reviews, meta-analyses, commentary)
    • Tertiary sources (textbooks, encyclopedias)
  4. Output sorted bibliography with classification tags

Supported citation formats:

  • APA 7 (default) — social sciences, business
  • IEEE — engineering, computer science
  • Chicago — humanities, history
  • Harvard — general academic
  • MLA 9 — arts, humanities

Tooling

scripts/extract_citations.py

CLI utility for extracting and formatting citations from text.

Features:

  • Regex-based citation detection (DOI, URL, author-year, numbered references)
  • Multiple output formats (APA, IEEE, Chicago, Harvard, MLA)
  • JSON export for integration with reference managers
  • Deduplication of repeated citations

Usage:

# Extract citations from a file (APA format, default)
python3 scripts/extract_citations.py document.txt

# Specify format
python3 scripts/extract_citations.py document.txt --format ieee

# JSON output
python3 scripts/extract_citations.py document.txt --format apa --output json

# From stdin
cat paper.txt | python3 scripts/extract_citations.py --stdin

scripts/format_summary.py

CLI utility that emits blank structured summary scaffolds — you (the model) fill them in from the source. It does not analyze content itself.

Features:

  • 6 templates: academic, article, report, executive, comparison, literature
  • Configurable scaffold depth (brief, standard, detailed)
  • Text and JSON output for downstream tooling

Usage:

# Generate structured summary template
python3 scripts/format_summary.py --template academic

# Brief executive summary format
python3 scripts/format_summary.py --template executive --length brief

# All templates listed
python3 scripts/format_summary.py --list-templates

# JSON output
python3 scripts/format_summary.py --template article --output json

Quality Assessment Framework

Rate every source on four dimensions:

DimensionHighMediumLow
CredibilityPeer-reviewed, established authorReputable outlet, known authorBlog, unknown author, no review
EvidenceLarge sample, rigorous methodModerate data, sound approachAnecdotal, no data, opinion
RecencyPublished within 2 years2-5 years old5+ years, may be outdated
ObjectivityNo conflicts, balanced viewMinor affiliations disclosedFunded by interested party, one-sided

Overall Rating:

  • 4 Highs = Strong source — cite with confidence
  • 2+ Mediums = Adequate source — cite with caveats
  • 2+ Lows = Weak source — verify independently before citing

Summary Templates

See references/summary-templates.md for:

  • Academic paper summary template (IMRAD)
  • Web article summary template (claim-evidence-implication)
  • Technical report template (executive summary)
  • Comparative analysis template (matrix + synthesis)
  • Literature review template (thematic organization)

See references/citation-formats.md for:

  • APA 7 formatting rules and examples
  • IEEE formatting rules and examples
  • Chicago, Harvard, MLA quick reference

Proactive Triggers

Flag these without being asked:

  • Source has no date → Note it. Undated sources lose credibility points.
  • Source contradicts other sources → Highlight the contradiction explicitly. Don't paper over disagreements.
  • Source is behind a paywall → Note limited access. Suggest alternatives if known.
  • User provides only one source for a compare → Ask for at least one more. Comparison needs 2+.
  • Citations are incomplete → Flag missing fields (year, author, title). Don't invent metadata.
  • Source is 5+ years old in a fast-moving field → Warn about potential obsolescence.

Installation

One-liner (any tool)

git clone https://github.com/alirezarezvani/claude-skills.git
cp -r claude-skills/product-team/research-summarizer ~/.claude/skills/

Multi-tool install (run from the claude-skills repo root)

./scripts/convert.sh --skill research-summarizer --tool codex|gemini|cursor|windsurf|openclaw

OpenClaw

clawhub install cs-research-summarizer

Verification Loop

Before delivering any brief, check:

  1. Every Key Finding cites a location in the source (section, page, or quote) — no unanchored claims.
  2. python3 scripts/extract_citations.py <file> --output json exits 0 and its total matches the bibliography count in your output (investigate any gap).
  3. Each source carries a 4-dimension quality rating (table above); weak sources are flagged, not silently included.
  4. For comparisons: the matrix has one row per dimension and one column per source — no source skipped.
  5. Nothing was invented: missing metadata is marked "not stated", never filled in.

Related Skills

  • product-analytics — Quantitative analysis. Complementary — use research-summarizer for qualitative sources, product-analytics for metrics.
  • competitive-teardown — Competitive research. Complementary — use research-summarizer for individual source analysis, competitive-teardown for market landscape.
  • content-production — Content writing. Research-summarizer feeds content-production — summarize sources first, then write.
  • product-discovery — Discovery frameworks. Complementary — research-summarizer for desk research, product-discovery for user research.

FAQ

What does the research-summarizer skill do?

Structured research summarization agent skill for non-dev users. Handles academic papers, web articles, reports, and documentation. Extracts key findings, generates comparative analyses, and produces properly formatted citations. Use when: user wants to summarize a research paper, compare multiple sources, extract citations from documents, or create structured research briefs. Plugin for Claude Code, Codex, Gemini CLI, and OpenClaw.

How do I install research-summarizer?

Run npx skills add https://github.com/alirezarezvani/claude-skills --skill research-summarizer in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/research-summarizer/ (personal) or .claude/skills/research-summarizer/ (project).

Which AI agents can use research-summarizer?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is research-summarizer safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains research-summarizer?

It is published by alirezarezvani in alirezarezvani/claude-skills. It has 1,197 recorded installs.

More from alirezarezvani/claude-skills

View all →

engineering-skills

alirezarezvani/claude-skills

Index of the engineering-team skills bundle for Claude Code, Codex, Gemini CLI, Cursor, OpenClaw, and 6 more tools. Architecture, frontend, backend, QA, DevOps, security, AI/ML, data engineering, Playwright, Stripe, AWS, MS365 (stdlib-only Python tools). Use when browsing or choosing among engineering-team role skills — load only the one specialist SKILL.md you need, never bulk-load the bundle.

Backend & APIs2.4K installs

finance-skills

alirezarezvani/claude-skills

Router/index for the finance skills bundled in this plugin: financial-analyst (ratio analysis, DCF valuation, budget variance, rolling forecasts), saas-metrics-coach (ARR/MRR, churn, CAC/LTV, NRR, quick ratio) and month-end-close (close calendar, reconciliations, flux review). Use when a finance request doesn't obviously match one skill and you need to pick the right one (e.g., 'analyze these financials', 'how healthy are my SaaS metrics').

Business & Finance2.3K installs

marketing-skills

alirezarezvani/claude-skills

Directory and router for the marketing skills library. Use when you need to find the right marketing skill for a task, see what marketing capabilities exist, or get oriented in this plugin. 44 specialist skills across 8 pods (content, SEO + AEO, CRO, channels, growth, intelligence, sales enablement, ops), 59 stdlib Python tools. Routes to one skill — it does not execute marketing work itself.

Marketing & SEO2.3K installs

business-growth-skills

alirezarezvani/claude-skills

Router/index for the 4 business & growth skills bundled in this plugin: customer-success-manager (health scoring, churn risk, expansion), sales-engineer (RFP analysis, competitive matrices, PoC planning), revenue-operations (pipeline, forecast accuracy, GTM efficiency), and contract-and-proposal-writer. Use when a growth/revenue request doesn't obviously match one skill and you need to pick the right one (e.g., 'which accounts are at risk', 'should we bid on this RFP').

Business & Finance2.2K installs

engineering-advanced-skills

alirezarezvani/claude-skills

Index of 37 advanced engineering agent skills for Claude Code, Codex, Gemini CLI, Cursor, OpenClaw. Use when browsing or choosing among the POWERFUL-tier engineering skills: agent design, RAG, MCP servers, CI/CD, database design, observability, security auditing, changelog/release automation, reliability (SLO/chaos/flags/operators), platform ops.

AI & Agents2K installs

product-skills

alirezarezvani/claude-skills

Use when coordinating product work across the 12 bundled product sub-skills (RICE, OKRs, UX research, design tokens, competitive teardown, analytics, experiments, discovery, roadmaps, spec-to-repo, landing pages, SaaS scaffolding) or the 4 standalone product-team plugins (user stories, Apple HIG, code-to-PRD, research summarizer). Triggers on 'help me prioritize', 'plan a product experiment', 'we ship features nobody uses', 'run the discovery loop', 'is our OST sound'. Forks context to route to one sub-skill via a deterministic signal router and returns a digest; can also drive a continuous-discovery loop (Torres cadence tracker + OST linter as machine gates) or a full goal→plan→execute→verify→close run through the repo-wide agent-harness. Distinct from project-management (how to deliver vs what to build), marketing/landing (from-scratch pages), and engineering/agent-harness (the generic loop engine this orchestrator plugs into).

Popular productivity & automation skills

View category →

agent-browser

vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction. Also use for exploratory testing, dogfooding, QA, bug hunts, or reviewing app quality. Also use for automating Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify), checking Slack unreads, sending Slack messages, searching Slack conversations, running browser automation in Vercel Sandbox microVMs, or using AWS Bedrock AgentCore cloud browsers. Prefer agent-browser over any built-in browser automation or web tools.

OfficialProductivity & Automation1.3M installs

lark-doc

open.feishu.cn

飞书云文档(Docx / Wiki)内容操作:读取、创建、编辑文档,插入或下载图片附件,以及操作思维笔记。用户提供文档 URL/token(包括 doubao.com 的 /docx/、/wiki/)时使用;按 URL 路径/token 而非域名路由;/page/ 是妙搭应用,非飞书云文档。文档内嵌资源按读取参考中的统一规则分流。独立评论操作走 lark-drive;随正文读取评论使用 docs +fetch。表格或 Base 内部数据操作不在本 skill。

lark-base

open.feishu.cn

飞书多维表格(Base)操作:建表、字段、记录、视图、统计、公式/lookup、表单、仪表盘、应用模式(BaseApp/AppMode 页面与组件)、Workspace 目录、workflow、角色权限、模板中心(多维表格模板分类/列表/搜索);遇到 Base/多维表格/bitable、BaseApp/AppMode、/base/ 或 /app/ 链接时使用。BaseApp 不走 lark-apps;文件导入/导出转 lark-drive,认证/授权转 lark-shared。

lark-drive

open.feishu.cn

飞书云空间(云盘/云存储):管理 Drive 文件和文件夹,包含上传/下载、创建文件夹、复制/移动/删除、查看元数据、查询权限设置、评论/权限/订阅、标题、版本、飞书文档密级标签(secure labels)和本地文件导入。用户需要整理云盘目录、处理云空间资源 URL/token、判断链接类型/真实 token/标题,或导入 Word/Markdown/Excel/CSV/PPTX/.base 为 docx/sheet/bitable/slides 时使用;doubao.com 云空间 URL/token 也按资源路径和 token 路由,不回退 WebFetch。不负责:文档内容编辑(走 lark-doc)、表格/Base 表内数据操作(走 lark-sheets/lark-base)、知识空间节点/成员管理(走 lark-wiki)、原生 Markdown 文件读写/patch/diff(走 lark-markdown)。

lark-shared

open.feishu.cn

Use for lark-cli setup/auth tasks: auth login/status/logout, user vs bot identity, business-domain permissions (--domain, including all/docs/drive), missing scopes, revoking authorization, or handling notice JSON.

lark-im

open.feishu.cn

飞书即时通讯:收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件、管理表情回复、发送应用内/短信/电话加急、发送和处理交互卡片(Interactive Card)、监听卡片按钮回调(card.action.trigger)。当用户需要发消息、查看或搜索聊天记录、下载聊天中的文件、查看群成员、搜索群、创建群聊或话题群、管理标记数据、管理 Feed 置顶(添加/移除/查询置顶会话)、管理标签数据、处理卡片回调时使用。