academic-slides

Files (9)

• LICENSE
• README.md
• SKILL.md
• STYLE_PRESETS.md
• css-architecture.md · references/
• html-architecture.md · references/
• ppt-conversion.md · references/
• style-and-animation.md · references/
• troubleshooting-and-examples.md · references/

SKILL.md (first lines)

# Academic Slides Skill

Create zero-dependency, Beamer-inspired HTML presentations that run entirely in the browser. This skill helps academics and researchers build professional presentations with proper theorem environments, equation rendering via KaTeX, and structured frame navigation. Users discover their preferred theme through visual exploration ("show, don't tell"), then the skill generates production-quality frame decks.

## Core Philosophy

1. **Zero Build Dependencies** -- Single HTML files with inline CSS/JS. KaTeX loaded via CDN for equations. No npm, no build tools.
2. **Show, Don't Tell** -- People don't know what they want until they see it. Generate visual theme previews for academic users.
3. **Academic Authenticity** -- Beamer-inspired structure, Computer Modern typography, proper theorem environments. Not PowerPoint-with-serif-fonts.
4. **Production Quality** -- Accessible, responsive, well-commented code.
5. **Viewport Fitting (CRITICAL)** -- Every frame MUST fit exactly within the viewport. No scrolling within frames, ever. This is non-negotiable.

---

## CRITICAL: Viewport Fitting Requirements

**This section is mandatory for ALL presentations. Every frame must be fully visible without scrolling on any screen size.**

### The Golden Rule

```text
Each frame = exactly one viewport height (100vh/100dvh)
Content overflows? -> Split into multiple frames or reduce content
Never scroll within a frame.
```

### Content Density Limits

To guarantee viewport fitting, enforce these limits per frame:

| Frame Type | Maximum Content |
|------------|-----------------|
| Title Frame | 1 title + 1 subtitle + author/institute/date block |
| Content Frame | 1 heading + 4-5 bullet points OR 1 heading + 2 short paragraphs |
| Theorem/Proof Frame | 1 theorem box (max 4 lines) + 1 proof sketch (max 5 lines) |
| Equation Frame | 1 heading + 1-3 display equations with optional annotation |
| Algorithm Frame | 1 heading + max 12 lines of pseudocode |
| Definition Frame | 1 heading + 1-2 definition boxes (max 3 lines each) |
| Citation/References Frame | 1 heading + max 8 reference entries |
| Section Divider Frame | 1 section number + 1 section title + optional outline |

**If content exceeds these limits -> Split into multiple frames**


### CSS 架構與溢版防治(已拆出)

撰寫任何 slide HTML/CSS 前,讀 `references/css-architecture.md`:必用的 CSS 骨架、溢版防治檢查清單、內容塞不下時的處理順序、視口貼合測試法。上方的 Golden Rule 與密度上限是鐵律,細節與程式碼全在該檔。

## Phase 0: Detect Mode

First, determine what the user wants:

**Mode A: New Academic Presentation**
- User wants to create slides from scratch for a talk, lecture, or defense
- Proceed to Phase 0.5 (Essential Content Questions), then Phase 1 (Content Discovery)

**Mode B: PPT/PDF/Paper Conversion**
- User has an existing PowerPoint, PDF, or paper URL to convert to web slides
- Proceed to Phase 4 (Content Extraction), then Phase 0.5, then Phase 1P (Paper Focus Discovery)

**Mode C: Existing Presentation Enhancement**
- User has an HTML presentation and wants to improve it
- Read the existing file, understand the structure, then enhance

### Fast-Path Detection

If the user's initial message specifies enough to skip format questions (e.g., topic, approximate length, and/or theme name are all present), you MAY skip the format-mechanical questions in Phase 1 (purpose, length, content types, field). However, you MUST still run Phase 0.5 (Essential Content Questions) before generating. **No presentation should ever be generated without asking the Phase 0.5 questions.**

**Examples of fast-path triggers:**
- "/academic-slides 10-slide lecture on dynamic programming using Metropolis"
- "/academic-slides conference talk on our ICML paper, Berlin theme"
- "Make 15 slides about transformer attention for my lab meeting"

In all of these cases, format is clear from context but content quality questions have not been answered. Proceed to Phase 0.5.

---

## Phase 0.5: Essential Content Questions (MANDATORY)

**These questions MUST be asked before generating any presentation, regardless of mode or how much information the user provided in their initial message.** They cannot be inferred from topic or theme -- they require the user's judgment. Ask all 3 in a single AskUserQuestion call.

### Why These Questions Matter

A presentation on "transformer attention" for a room of NLP researchers looks completely different from one for undergraduate CS students. A talk where the takeaway is "our method is 3x faster" structures differently from one where the takeaway is "this theoretical framework unifies prior work." These questions determine content strategy, not just format.

### The Questions (Single AskUserQuestion Call)

**Question 1: Audience**
- Header: "Audience"
- Question: "Who is your audience?"
- Options:
  - "Domain experts" -- They know the field well; skip basics, focus on contributions and technical details
  - "Technical but not specialist" -- They have technical background but are not in your exact subfield
  - "Students / newcomers" -- They need context, definitions, and motivation before results
  - "Mixed / general academic" -- Varies widely; balance accessibility with depth

**Question 2: Key Takeaway**
- Header: "Takeaway"
- Question: "If the audience remembers ONE thing from your talk, what should it be?"
- Options:
  - "A specific result" -- A theorem, benchmark, or experimental finding (will ask you to state it)
  - "A new method or technique" -- How to do something they could not do before
  - "A conceptual framework" -- A way of thinking about a problem or connecting ideas
  - "A problem or open question" -- Motivating future work or collaboration

**Question 3: Narrative Arc**
- Header: "Structure"
- Question: "How should the presentation flow?"
- Options:
  - "Problem -> Solution -> Results" -- Classic research talk structure
  - "Background -> Our Work -> Impact" -- Contextualizes contribution in the field
  - "Survey / Comparison" -- Review multiple approaches, compare trade-offs
  - "Build-up / Tutorial" -- Teach concepts progressively, layer by layer

### Follow-Up: Key Result Statement

If the user chose "A specific result" as their takeaway, follow up immediately:

"Please state the key result in one sentence. This will be featured prominently in the slides."

From Nero1688/claude-academic-skills, MIT.

More from Nero1688/claude-academic-skills