readme-to-presentation

Reads a GitHub README and generates a stunning, self-contained, slide-by-slide HTML presentation — with dark/light mode toggle, keyboard navigation, syntax-highlighted code blocks, and AI-inferred slide structure.

Core Principles

1. Zero Dependencies — Single self-contained HTML file. All CSS, JS, fonts inline. No npm, no build tools.
2. AI-Inferred Structure — Intelligently groups README content into meaningful slides: intro, features, installation, usage, API, contributing, etc.
3. Premium Aesthetics — Elegant, eye-catching design. If the user specifies a style/theme, use that; otherwise use the elegant default theme defined in this skill.
4. Dual Mode — Every presentation ships with a dark/light mode toggle button.
5. Viewport Fitting — Every slide fits exactly within 100vh. No scrolling within a slide. Content overflows? Split into multiple slides.

Phase 0: Input Detection

Accept $ARGUMENTS as the input. Detect the format: