agent-deck

One HTML file that presents, edits itself live, and exports a clean 16:9 PDF.
Slides for the AI-agent era — the deck is the source, the player, and the editor.

English · 简体中文 · 한국어

▶ Live Demo — open it and press ?

---

Why replace PowerPoint?

	PowerPoint (.pptx)	agent-deck (.html)
AI agents	Binary black box; needs toolchains	Plain text — any agent reads & rewrites the whole file in one turn
Editing during the talk	Exit slideshow → edit → restart	Press E, edit right on the slide
Version history	Filename discipline, if you're lucky	Revision log embedded inside the file, auto-versioned filenames
Distribution	Needs Office; fonts break	Any browser, fully offline; PDF snapshot rendered by the browser's own print engine

Features

• Present — 16:9 (1280×720), keyboard navigation, fullscreen, deep links (#5), toolbar and cursor auto-hide while presenting: the audience sees nothing but slides.
• Edit live — press E: every slide becomes editable in place. Paste is forced to plain text; edits autosave to localStorage; reopening offers a restore banner; over-tall content gets a red warning before the PDF silently crops it.
• Presenter view — press S: a popup with your per-slide notes, a next-slide preview and a timer. Notes live inside the file (<aside class="notes">), invisible to the audience and excluded from the PDF.
• Versioned by design — Save new version opens a system save dialog and writes title_v02_date.html straight back to disk (File System Access API; download fallback), with your change note appended to the embedded revision log. Ctrl+S is intercepted (the browser's native "save page" would silently lose your edits).
• One-click PDF — window.print() with @page sized exactly like a PowerPoint 16:9 page. One slide per page, UI hidden, backgrounds preserved, no trailing blank page. Zero libraries.
• Agent-native — a written contract (PROMPT.md) lets any AI agent (Claude, ChatGPT, Gemini, DeepSeek…) generate or modify compliant decks. The contract is the interface.

Quick start

1. Grab template.html and open it in Chrome/Edge — that's already a usable deck;
2. → to navigate, F for fullscreen, move the mouse to summon the toolbar;
3. E to edit, then Save new version → you get deck_v02_date.html with the revision log inside;
4. Export PDF → print dialog → Save as PDF → a one-slide-per-page 16:9 PDF.

Generate decks with any AI agent

PROMPT.md ships three ready-to-paste prompts (an English translation lives in PROMPT.en.md; the Chinese contract is canonical):

• Step zero — pick a master: academic light (default) or the corporate pitch master — routing table at the top of PROMPT.md;
• A — template fill (default): send the chosen master + your outline to any model — the machinery travels with the golden master, the model only touches the marked content region;
• A-pro — two-step generation (strong models): a one-page plan first, fill after you confirm it;
• A-max — creative mode (strong models, on explicit request): free-form layouts plus a namespaced .x- custom-style zone and re-theming — machinery still untouchable, the checker still the judge;
• B — incremental edits (daily driver): send your current vN.html + the B prompt;
• C — migrate from PPT: send the master + your old deck's per-slide text;
• A+ — runtime from scratch (advanced; strongest models only, for developing new masters).

Then run the 60-second acceptance checklist at the bottom of PROMPT.md. Any failed item goes straight back to the agent, verbatim.

The checklist is executable

Every push runs the conformance checker against both masters in CI — 32 automated checks each: offline loading (all external requests blocked), navigation, live editing, autosave, plain-text paste, serialization, print CSS, even PDF page count and 16:9 page size. Verify any deck yourself:

cd checker && npm install && npx playwright install chromium
node check.mjs path/to/your-deck.html

Any deck from any agent that honors the contract's machine-checkable anchors (contract item 7) can be verified the same way. Cross-agent conformance reports are welcome.

Cross-agent conformance record

Agent	Mode	Result
Claude (reference)	master development	31/31
DeepSeek	A · template fill	31/31 (3rd run; runs 1–2 failed and drove the paradigm fixes — see CHANGELOG v0.4–v0.5)

What a slide looks like

Charts are inline SVG — editable in place, tiny file size, no bitmap screenshots. While presenting, hover a bar to read its exact value (disabled in edit mode; the PDF falls back to the static numbers printed on the chart).

Known limits (the honest section)

• PDF fidelity is per-machine. Slides use a system font stack, so export the final PDF on your own machine with Chrome/Edge; another machine's fonts may shift line breaks slightly. What you see in your browser is what your PDF gets.
• Editing is text-level, not layout-level. Perfect for changing words, numbers and bullets mid-meeting; this is not a WYSIWYG layout tool like PowerPoint.
• Single-user, single-file by design. Versioning is built in; real-time collaboration is not.

When NOT to use agent-deck

• Complex animations, transitions, embedded audio/video → PowerPoint / Keynote;
• The venue explicitly requires a .pptx file → use a pptx pipeline;
• Several people editing simultaneously → Google Slides or similar;
• Poster-grade layout design → a design tool.

agent-deck deliberately trades all of the above for single-file portability, zero dependencies, agent-writability and live editing. That trade is the product.

Install as a Claude Code skill

Copy skill/ to ~/.claude/skills/agent-deck/ and say /agent-deck. The skill generates decks from the template, then self-verifies them (script integrity, navigation, autosave, serialization, zero external references) before handing you the file.

Repository layout

File	Role
template.html	Academic light master (canonical) — a ready-to-use deck and the "gold answer" you can show any agent
masters/corporate.html	Corporate pitch master — dark, big-number stats, 8-slide pitch narrative; same machinery, same 31 checks, with a ✂ THEME-TOKENS ✂ brand-color zone
PROMPT.md	The contract, three usage prompts, acceptance checklist (canonical, Chinese)
PROMPT.en.md	English translation of the contract
METHODOLOGY.md	Full methodology: design rationale, workflow, known pitfalls (Chinese)
DESIGN.md	Visual identity spec (Chinese)
skill/SKILL.md	Claude Code skill

Three rules of discipline

1. The file is the truth — browser autosave is only a safety net; always Save new version after the meeting;
2. Zero dependencies is a red line — no CDN, no web fonts, no bitmap screenshots, ever;
3. Export PDF from Chrome/Edge — check Background graphics, uncheck Headers and footers.

License

MIT — take it to your lab meeting, your team review, or anywhere PowerPoint is still causing pain.