openclaw-skill/skills/research-to-paper-slides/SKILL.md

name, description

name

description

research-to-paper-slides

Turn local analysis outputs into publication-style drafts and presentation materials. Use when the user already has research/data-analysis artifacts such as summary.json, report.md, preview.csv, plots, or code-interpreter output and wants a complete first-pass paper draft, slide outline, speaker notes, or HTML deck. Especially useful after using the code-interpreter skill on small-to-medium datasets and the next step is to package findings into a paper, report, pitch deck, class slides, or meeting presentation.

research-to-paper-slides

Generate a complete first-pass writing bundle from analysis artifacts.

Inputs

Best input bundle:

• summary.json
• report.md
• one or more plot PNG files

Optional:

• preview.csv
• raw CSV/JSON/XLSX path for source naming only
• extra notes from the user (audience, tone, purpose)

Levels

Choose how far the workflow should go:

• --level v2 — 基礎交付版

  • 輸出：paper.md、slides.md、speaker-notes.md、deck.html
  • 適合：快速草稿、先出第一版內容
  • 不包含：insights.md、逐圖解讀頁、正式 deck 視覺強化

• --level v3 — 洞察強化版

  • 包含 v2 全部內容
  • 另外增加：insights.md、每張圖各一頁解讀、speaker notes 逐圖講稿
  • 適合：內部討論、研究整理、需要把圖表講清楚

• --level v4 — 正式交付版

  • 包含 v3 全部內容
  • 另外增加：更正式的 deck 視覺版面、PDF-ready 工作流
  • 適合：正式簡報、提案、對外展示

Modes

• academic — 論文/研究報告/研討會簡報
• business — 內部決策/管理匯報/策略說明
• pitch — 提案/募資/對外說服型簡報

Outputs

Depending on --level, the generator creates:

• paper.md — structured paper/report draft
• slides.md — slide-by-slide content outline
• speaker-notes.md — presenter script notes
• insights.md — key insights + plot interpretations (v3 / v4)
• deck.html — printable deck HTML
• bundle.json — machine-readable manifest with level and levelNote

Optional local export:

• export_pdf.py — export deck.html to PDF via local headless Chromium

Workflow

1. Point the generator at an analysis artifact directory.
2. Pass --mode for audience style.
3. Pass --level for workflow depth.
4. Review the generated markdown/html.
5. If needed, refine wording or structure.
6. If using v4, export deck.html to PDF.

Commands

V2 — 基礎交付版

python3 {baseDir}/scripts/generate_bundle.py \
  --analysis-dir /path/to/analysis/out \
  --output-dir /path/to/paper-slides-out \
  --title "研究標題" \
  --audience "投資人" \
  --purpose "簡報" \
  --mode business \
  --level v2

V3 — 洞察強化版

python3 {baseDir}/scripts/generate_bundle.py \
  --analysis-dir /path/to/analysis/out \
  --output-dir /path/to/paper-slides-out \
  --title "研究標題" \
  --audience "研究者" \
  --purpose "研究整理" \
  --mode academic \
  --level v3

V4 — 正式交付版

python3 {baseDir}/scripts/generate_bundle.py \
  --analysis-dir /path/to/analysis/out \
  --output-dir /path/to/paper-slides-out \
  --title "研究標題" \
  --audience "投資人" \
  --purpose "募資簡報" \
  --mode pitch \
  --level v4

PDF export

If local Chromium is available, try:

python3 {baseDir}/scripts/export_pdf.py \
  --html /path/to/deck.html \
  --pdf /path/to/deck.pdf

Notes

• Prefer this skill after code-interpreter or any workflow that already produced plots and structured summaries.
• Keep this as a first-pass drafting tool; the output is meant to be edited, not treated as final publication-ready text.
• On this workstation, Chromium CLI --print-to-pdf may still fail with host-specific permission/runtime quirks even when directories are writable.
• When the user wants a PDF, try export_pdf.py first; if it fails, immediately fall back to OpenClaw browser PDF export on a locally served deck.html.