OpenParable
Skip to content
← Back to skills

Slides As Code

Documents
slides-as-code

Slides As Code is an Agent Skill for documents published in the foryourhealth111-pixel/Vibe-Skills repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Build research slides with text-first source (Slidev/Marp/Reveal/Quarto) and reproducible export (PDF). Includes structure, figure reuse rules, and quality checklist for top-tier scientific presentations.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/foryourhealth111-pixel/Vibe-Skills/blob/HEAD/bundled/skills/slides-as-code/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/slides-as-code, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Slides as Code（顶级科研汇报的可复现幻灯片）

目标

解决常见问题：

  • PPT 版本失控（final_v7）
  • 图表重复截图、清晰度崩坏
  • 汇报结构不稳定（信息密度失衡）

本 skill 让 slides 拥有：

  • 文本源（Markdown / Quarto / LaTeX Beamer）
  • 可复现导出（PDF、可选 PPTX）
  • 图表复用（直接引用 figures/ 最终导出，不截图）

技术路线（按约束选）

  1. Slidev：开发者友好，组件化，适合组会/技术分享
  2. Marp：排版可控，适合快速生成简洁风格
  3. Reveal.js：网页交互强，适合 demo/交互展示
  4. Quarto slides：报告/论文/幻灯片一体化（推荐用于报告+slides联动）

内容结构建议使用 scientific-slides；本 skill 更偏“工程化与导出管线”。

元规则（幻灯片质量的 80/20）

1) 一页一结论

  • 标题就是结论，不是主题
  • 每页只服务一个问题：What / Why / How / So what

2) 图不截图

  • 图只从 figures/**/out/ 引用（PDF/SVG/PNG）
  • 禁止从论文 PDF 截图再贴回 PPT

3) 讲述顺序固定

推荐骨架：

  1. 背景与缺口（1–2 页）
  2. 方法直觉（1–2 页示意图）
  3. 核心结果（3–6 页，每页一图一结论）
  4. 局限与下一步（1–2 页）

模板

参考：templates/slidev-structure.md