Selig
f1a6df4ca4
- Add code-interpreter, kokoro-tts, remotion-best-practices, research-to-paper-slides, summarize, tavily-tool to source repo - skill-review: add main/xiaoming agent mapping in handler.ts + SKILL.md - tts-voice: handler.ts updates from agent workspace Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
126 lines
4.0 KiB
Markdown
126 lines
4.0 KiB
Markdown
---
|
|
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`.
|