research-report

Generates a markdown summary report from deep research JSON results via a Python script.

1|Updated Jul 12, 2026
One-click install
npx skills add https://github.com/matsumuratk/elmo-aws --skill research-report-matsumuratk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: research-report
Source: https://github.com/matsumuratk/elmo-aws/tree/main/.claude/skills/research-report
Command: npx skills add https://github.com/matsumuratk/elmo-aws --skill research-report-matsumuratk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Deep research workflows produce many scattered JSON result files with inconsistent structures and uncertain values, making it hard to assemble a readable, complete summary report manually. ## Core Features & Use Cases - Automated Report Generation: Scans all JSON results in the research output directory and generates a markdown report with a table of contents and detailed sections grouped by field category. - Uncertainty Filtering: Skips fields marked with [uncertain], listed in the uncertain array, or empty, so the report only contains confident values. - Flexible Structure Handling: Supports both flat and nested JSON structures with bilingual (Chinese/English) category mapping, plus user-selected summary fields shown in the TOC. - Use Case: After running deep research on 20 AI coding tools, invoke this Skill to produce report.md with an anchored TOC showing stars and citations per tool, followed by full categorized details. ## Quick Start Run /research-report in the directory containing your research outline.yaml and JSON results to generate the summary report.

Frequently Asked Questions about research-report

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

FAQPage Schema
How do I generate a markdown report from multiple JSON research files?▼

Place your JSON results in the output directory referenced by outline.yaml, then invoke /research-report. It scans all JSON files, asks which summary fields to show in the TOC, generates a Python conversion script, and runs it to produce report.md.

How are uncertain or missing research values handled in the report?▼

Fields whose values contain the [uncertain] marker, whose names appear in the uncertain array, or whose values are null or empty are skipped entirely. The uncertain field names are listed separately, one per line.

Does the report support nested JSON structures and Chinese field names?▼

Yes. The generated script handles both flat and nested JSON layouts and uses a bidirectional category mapping so Chinese or English category names in fields.yaml and JSON keys are matched correctly.

Can I choose which fields appear in the report table of contents?▼

Yes. The Skill scans the JSON results for short numeric or metric fields such as github_stars or swe_bench_score, then asks via an interactive question which of them to display next to each item in the TOC.

What happens to JSON fields not defined in fields.yaml?▼

Extra fields are collected into an Other Info category in the report. Internal fields like _source_file, uncertain, and nested top-level category keys are filtered out automatically.