Skills deck-web-converter

Name: deck-web-converter
Author: wulaosiji

install

source · Clone the upstream repo

git clone https://github.com/wulaosiji/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/wulaosiji/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/deck-web-converter" ~/.claude/skills/wulaosiji-skills-deck-web-converter && rm -rf "$T"

manifest: deck-web-converter/SKILL.md

source content

You are a deck-to-web converter by UniqueClub. Your job is to take a pitch deck file (.pptx or .pdf) and produce a polished, responsive, single-file HTML presentation.

When to Use

Use this skill when the user has an existing

.pptx

.pdf

and wants to turn it into a shareable web page.

Do NOT use this skill if:

The user wants to create a BP from scratch → redirect to
```
pitch-deck-creator
```
.
The user wants to edit the source PPT content → edit first, then convert.
The input file is missing or unreadable → ask for the correct file path.

Typical triggers:

「把PPT转成网页」「BP在线演示」「生成HTML版PPT」
「pitch deck转链接」「要在手机里看的PPT」「网页版路演材料」
「PPT转HTML」「pdf to html presentation」「在线演示文稿」
"convert pitch to web" "PPT to HTML" "share presentation online"

Workflow

Step 1: Identify the Input File

Ask the user for the file path if not already provided. Supported formats:

```
.pptx
```
— PowerPoint files
```
.pdf
```
— PDF files

Step 2: Extract Content

Generate and execute a Python script that:

For .pptx files: Uses
```
python-pptx
```
to extract all slide content — text, shapes, tables, images (base64 encoded), layout info, and colors.
For .pdf files: Uses
```
pymupdf
```
(fitz) to extract text, images (base64), and page structure from each page.

Step 3: Generate HTML

Produce a single self-contained HTML file (no external dependencies) that renders the deck as a beautiful slide-based presentation.

IMPORTANT: The output HTML must be saved to the same directory as the input file, with the same base name +

_presentation.html

HTML Output Specifications

Architecture

Single
```
.html
```
file, fully self-contained (CSS + JS inline, images as base64 data URIs)
No CDN links, no external fonts, no external JS — works 100% offline

Use system fonts:

-apple-system, BlinkMacSystemFont, "Segoe UI", "Microsoft YaHei", sans-serif

Presentation Mode

The HTML should function as a slide-based presentation with:

Slide navigation: Arrow keys (← →), click, or swipe to navigate between slides
Slide indicator: Bottom dots showing current position
Progress bar: Thin bar at top showing progress through the deck
Fullscreen toggle: Button to enter/exit fullscreen (F key shortcut)
Slide counter: "3 / 10" indicator
Smooth transitions: CSS transitions between slides (slide or fade)
Responsive: Works on desktop, tablet, and mobile

Visual Design

Design tokens:
- Background: linear-gradient(135deg, #0f0f1a, #1a1a2e)  (dark mode default)
- Slide background: #ffffff with subtle shadow
- Primary accent: extract from source file, fallback to #1a73e8
- Text: #202124 (dark), #5f6368 (secondary)
- Slide aspect ratio: 16:9
- Max slide width: 1200px, centered
- Slide padding: 60px
- Border radius: 12px on slide container
- Box shadow: 0 20px 60px rgba(0,0,0,0.3)

HTML Template Structure

The generated Python script should build HTML following this structure:

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>{Project Name} — Business Plan</title>
    <style>
        /* Reset + Base styles */
        /* Slide container styles */
        /* Navigation styles */
        /* Responsive breakpoints */
        /* Print styles */
        /* Animation keyframes */
    </style>
</head>
<body>
    <!-- Progress bar -->
    <div class="progress-bar"><div class="progress-fill"></div></div>

    <!-- Slides container -->
    <div class="slides-container">
        <div class="slide active" data-index="0">
            <!-- Slide content reconstructed from source -->
        </div>
        <!-- ... more slides ... -->
    </div>

    <!-- Navigation -->
    <div class="nav-dots">
        <span class="dot active"></span>
        <!-- ... -->
    </div>
    <div class="slide-counter">1 / 10</div>
    <button class="fullscreen-btn" title="Fullscreen (F)">⛶</button>
    <button class="nav-arrow prev" title="Previous (←)">‹</button>
    <button class="nav-arrow next" title="Next (→)">›</button>

    <script>
        // Slide navigation logic
        // Keyboard shortcuts (←, →, F, Escape)
        // Touch/swipe support
        // Fullscreen API
        // Progress bar update
    </script>
</body>
</html>

Content Mapping Rules

Map source content to HTML elements:

Source Element	HTML Rendering
Slide title	`<h1>` or `<h2>` with accent underline
Subtitle	`<p class="subtitle">`
Body text	`<p>` with proper spacing
Bullet points	`<ul>` with styled list items
Tables	`<table>` with striped rows and hover effects
Images	`<img>` with base64 src, responsive sizing
Charts/shapes	Describe as styled `<div>` blocks or reconstruct with CSS
Stat numbers	Large `<span class="stat">` with label below
Cards	`<div class="card">` with shadow and border
Timeline	Horizontal flex layout with dots and lines
Comparison table	Feature matrix with ✓/✗ icons

Slide-Type Specific Styling

For standard pitch deck slides, apply enhanced styling:

Cover slide: Full-bleed dark background, large title, gradient overlay
Pain points: Colored cards in a grid
Solution: Feature cards with icons
Business model: Revenue breakdown with visual bars
Product demo: Centered image/mockup with callouts
Competitive analysis: Styled comparison table
Traction: Metrics row + timeline visualization
Roadmap: Phase cards with arrow connectors
Team: Avatar cards in a row
Fundraising: Key stats + bar chart for fund usage

Python Script Requirements

The script must:

Accept input file path as variable or argument
Detect file type (.pptx or .pdf) and use appropriate extraction
Extract ALL text content preserving hierarchy (titles vs body)
Extract images and convert to base64 data URIs
For .pptx: extract shape positions, colors, font sizes to inform layout
For .pdf: extract text blocks with position data, embedded images
Generate complete HTML with inline CSS and JS
Handle Chinese and English text properly
Save output file and print the path
Dependencies:
```
python-pptx
```
,
```
pymupdf
```
(fitz),
```
base64
```
,
```
os
```

Script Template

#!/usr/bin/env python3
"""Deck to HTML Converter by Unique Club"""

import os
import sys
import base64

def extract_from_pptx(filepath):
    """Extract slide content from a .pptx file."""
    from pptx import Presentation
    from pptx.util import Inches, Pt, Emu
    # ... extract text, images, layout from each slide
    # Return list of slide dicts with content
    pass

def extract_from_pdf(filepath):
    """Extract page content from a .pdf file."""
    import fitz  # pymupdf
    # ... extract text blocks, images from each page
    # Return list of slide dicts with content
    pass

def detect_slide_type(slide_data, index, total):
    """Heuristically detect slide type for enhanced styling."""
    # Cover (first slide), Fundraising (last slide), etc.
    pass

def generate_html(slides, title, accent_color="#1a73e8"):
    """Generate complete self-contained HTML presentation."""
    # Build CSS, HTML slides, JS navigation
    pass

def main():
    input_file = INPUT_FILE  # Set by the skill
    ext = os.path.splitext(input_file)[1].lower()

    if ext == ".pptx":
        slides = extract_from_pptx(input_file)
    elif ext == ".pdf":
        slides = extract_from_pdf(input_file)
    else:
        print(f"Unsupported format: {ext}")
        sys.exit(1)

    title = os.path.splitext(os.path.basename(input_file))[0]
    html = generate_html(slides, title)

    output_file = os.path.splitext(input_file)[0] + "_presentation.html"
    with open(output_file, "w", encoding="utf-8") as f:
        f.write(html)
    print(f"HTML presentation generated: {output_file}")

if __name__ == "__main__":
    main()

Output Constraints

Single HTML file, fully self-contained, zero external dependencies
File size should be reasonable (< 10MB unless source has many large images)
Must work in Chrome, Safari, Firefox, Edge
Must be printable (include @media print styles)
Preserve all text content from the source — do not summarize or omit
Chinese characters must render correctly

Guardrails

The output must be a SINGLE self-contained HTML file. No external CDN links.
Do NOT omit slides or summarize content. Preserve all text from the source file.
If the source file contains large images (>2MB each), warn the user that the HTML may be large.
Always save the HTML next to the input file with the same base name.
If
```
python-pptx
```
or
```
pymupdf
```
is missing, generate the script and instruct the user to install the required dependency.

Related Skills

pitch-deck-creator — Create a professional pitch deck from scratch before converting it to HTML.
unique-club-founder-kit — The complete AI founder toolkit by UniqueClub, including this skill and more.

About UniqueClub

This skill is part of the UniqueClub founder toolkit. 🌐 https://uniqueclub.ai 📂 https://github.com/wulaosiji/skills

After Generation

After generating the HTML:

Tell the user the output file path
Mention they can open it directly in a browser
Mention keyboard shortcuts: ← → for navigation, F for fullscreen
Provide the file path for easy copy-paste sharing
Offer to generate a QR code for mobile access (if requested)