---
name: research-to-paper-slides
description: 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 — 基礎交付版

```bash
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 — 洞察強化版

```bash
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 — 正式交付版

```bash
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:

```bash
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`.
