research-report

Convert deep-research JSON outputs into structured Markdown reports with TOC.

203|27|Updated Apr 19, 2026
One-click install
npx skills add https://github.com/franklee16/academic-research-skills --skill research-report-franklee16
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: research-report
Source: https://github.com/franklee16/academic-research-skills/tree/main/literature-review/Deep-Research-skills-master/skills/research-codex-en/research-report
Command: npx skills add https://github.com/franklee16/academic-research-skills --skill research-report-franklee16

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It converts scattered deep-research JSON outputs into a single, readable Markdown report that’s suitable for sharing, review, or publishing—while skipping uncertain values.

Core Features & Use Cases

  • End-to-end report generation: Creates a conversion script that reads JSON results and produces a {topic}/report.md Markdown deliverable.
  • User-controlled TOC highlights: Builds a table of contents that includes each item and the user-selected summary fields for quick scanning.
  • Robust JSON handling: Supports both flat JSON and nested category JSON structures, using a bidirectional category mapping derived from fields.yaml.
  • Quality filtering: Skips fields containing [uncertain], skips names listed in an uncertain array, and ignores empty/None values.
  • Readable formatting rules: Formats lists/dicts (including funding-style histories), adds line breaks for long text, and aggregates extra, undefined fields into an “Other Info” section.

Quick Start

Run the /research-report trigger in your workspace to generate {topic}/report.md from the JSON results found in the output directory.

Frequently Asked Questions about research-report

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

FAQPage Schema
How do I convert JSON research data into a Markdown report?

To convert JSON research data into a Markdown report, use a generator that parses deep-research JSON outputs and writes a structured summary file. This process reads flat or nested JSON, applies category mappings, filters out uncertain values, and outputs a clean Markdown document.

How do I generate a table of contents from JSON fields for an academic synthesis?

Generating a table of contents from JSON fields involves mapping data categories using a configuration file and building a TOC that highlights user-selected summary fields. This allows quick scanning of items and their specific details within the generated Markdown report.

Can I automatically skip uncertain or empty values when converting JSON to Markdown?

Yes, you can automatically skip uncertain or empty values during JSON to Markdown conversion by applying quality filtering rules. The process ignores empty values, skips fields containing [uncertain] tags, and excludes names listed in a designated uncertain array.

Does deep research report generation work with nested category JSON structures?

Deep research report generation works with both flat JSON and nested category JSON structures. It uses a bidirectional category mapping derived from a fields configuration file to correctly interpret and organize the data into the final Markdown output.

What configuration files do I need to organize multi-source research results into a report?

To organize multi-source research results into a report, you need an outline.yaml file for topic and output directory configuration, and a fields.yaml file for category mappings. These files guide the parsing and structuring of the JSON data into the final report.