synthesize-report

Generates citation-grounded Markdown reports from workspace source files.

5.4k|1.3k|Updated Sep 23, 2025
One-click install
npx skills add https://github.com/agentscope-ai/agentscope-java --skill synthesize-report
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: synthesize-report
Source: https://github.com/agentscope-ai/agentscope-java/tree/main/agentscope-examples/agents/agentscope-paw/src/main/resources/templates/research-assistant/skills/synthesize-report
Command: npx skills add https://github.com/agentscope-ai/agentscope-java --skill synthesize-report

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writing summaries, briefings, or literature reviews from scattered workspace files often leads to unsupported claims and missing citations. This Skill provides a structured playbook for producing reports where every statement is backed by a quote and a file path.

Core Features & Use Cases

  • Source Inventory and Skimming: Uses list_files, read_file, and grep_files to locate and scan the most relevant files in the workspace.
  • Claim Extraction with Citations: Captures each claim as one sentence, a supporting quote of 25 words or fewer, and the source file path.
  • Topic-Grouped Report Composition: Clusters claims by topic rather than by source file and writes a Markdown report following the AGENTS.md template, ending with a ## Sources section.
  • Use Case: A researcher asks for a literature review across a folder of notes; the agent inventories the files, extracts cited claims, groups them by theme, and produces a briefing where every sentence is verifiable.

Quick Start

Ask the agent to synthesize a citation-grounded report from the files in a specified workspace directory.

Frequently Asked Questions about synthesize-report

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a report from multiple workspace files?

Run list_files on the target directory to inventory candidates, read each file to extract claims with short supporting quotes, group claims by topic, and compose a Markdown report following the AGENTS.md template with a Sources section.

How to write a literature review with citations from local files?

Extract each claim as one sentence paired with a quote of 25 words or fewer and its file path. Cluster the claims by topic rather than by source, then compose the review and verify every sentence has citation support.

What tools does the report synthesis workflow require?

The workflow relies on workspace file tools: list_files for inventory, read_file for skimming content, and grep_files for locating relevant passages. No external packages or scripts are needed.

When should I not use citation-grounded report synthesis?

Avoid it when source material is not reachable through workspace file tools or when the task needs original analysis rather than summarization. It is designed for summarizing existing files, not generating new research.

Why does the report include unsupported sentences?

Unsupported sentences appear when the self-check step is skipped. Re-read the draft and remove any sentence that lacks a captured claim, quote, and file path before finalizing the report.