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.