add 6 skills to repo + update skill-review for xiaoming

- 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>
2026-03-13 22:59:31 +08:00
parent da6e932d51
commit f1a6df4ca4
24 changed files with 1690 additions and 0 deletions
--- a/skills/research-to-paper-slides/SKILL.md
+++ b/skills/research-to-paper-slides/SKILL.md
@@ -0,0 +1,125 @@
+---
+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`.