research-report

Generate markdown summary reports from deep research JSON files.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Jamie-Cui/opt --skill research-report-jamie-cui
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: research-report
Source: https://github.com/Jamie-Cui/opt/tree/main/dotfiles/skills/research-report
Command: npx skills add https://github.com/Jamie-Cui/opt --skill research-report-jamie-cui

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the process of summarizing complex research findings into a structured markdown report, making it easier to digest and share deep research results.

Core Features & Use Cases

  • Automated Report Generation: Converts raw research data (JSON) into a well-formatted markdown report.
  • Selective Data Inclusion: Allows users to choose which summary fields appear in the table of contents and skips uncertain values.
  • Use Case: After running a series of experiments, use this Skill to generate a concise report highlighting key metrics like GitHub stars, citation counts, and valuation, while omitting speculative data.

Quick Start

Generate a research report for the topic 'ai-models' using the data in the current 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, this skill extracts specified numeric and short metric fields for a table of contents while detailing all other fields in the report body. It processes both flat and nested JSON structures to generate a structured summary.

Can I generate a markdown summary that skips uncertain values from my research results?

Yes, you can skip uncertain values when generating a markdown summary. The skill explicitly skips fields with uncertain values or those listed as uncertain, ensuring only validated data appears in your research report's table of contents and body.

How does markdown report generation handle nested JSON structures and multi-language categories?

Markdown report generation handles nested JSON by formatting complex values and collecting extra undefined fields. It supports multi-language category mapping, accurately extracting and formatting data from both flat and deeply nested JSON files into the report.

What is the best way to format complex research metrics into a structured table of contents?

The best way to format complex research metrics into a table of contents is by selecting specific numeric and short fields from your JSON data. The skill places these in the contents while detailing all remaining fields in the report body.

Does this report generation tool require any external dependencies to process JSON files?

No, this report generation tool requires no external dependencies to process JSON files. It operates independently to extract, format, and summarize your research data into markdown without needing additional libraries or scripts.

Are there limitations when summarizing raw research data into markdown using automation?

A limitation when summarizing raw research data is that fields with explicitly uncertain values are automatically skipped. Additionally, any extra fields not initially defined in your JSON structure are collected and placed in the report body rather than the table of contents.