jxnl/slidev-presentation-kit

Slidev Presentation Kit

Overview

Create and modify Slidev decks in slides/decks/ using the repo's drafting and polishing workflow. Ask only when blocked, work incrementally, and change one slide at a time.

Workflow Decision Tree

• New presentation or heavy drafting: Read references/repo/docs/DRAFTING.md then references/repo/docs/BASICS.md. Avoid animations.
• Editing existing slides: Read references/repo/AGENTS.md for workflow rules, then references/repo/SLIDEV.md for conventions.
• Polishing or animations: Read references/repo/docs/POLISHING.md and references/repo/SLIDEV_POLISHING.md before making changes.
• Syntax lookup: Check references/repo/docs/REFERENCE.md first, then references/repo/docs/ADVANCED.md if needed.
• Components: Use only QRCode during drafting; full component set only during polishing. See references/repo/slides/components/README.md.

Core Rules

• Ask clarifying questions only when a decision is truly blocking; otherwise assume and proceed.
• Make one change at a time and get feedback before continuing.
• Work on one slide at a time; do not batch edits.
• Do not add animations during drafting.
• Keep click alignment comments and speaker notes synchronized when using v-click.

Repo Setup

• Each deck needs a components/ symlink to ../../components. See references/repo/AGENTS.md for the exact command.
• Always check for deck-specific slides/decks/<deck-name>/AGENTS.md in the repo before editing a deck.

References

Use references/repo/ as the primary source of truth for this repo. It mirrors all Markdown in /Users/jasonliu/dev/presentations except slides/decks/.

Key entry points:

• references/repo/AGENTS.md
• references/repo/SLIDEV.md
• references/repo/SLIDEV_POLISHING.md
• references/repo/docs/
• references/repo/slides/README.md
• references/repo/slides/components/README.md