AgentSkillsCN

Slide Design

幻灯片设计

SKILL.md

Slide Design Skill

Use this skill when creating or modifying slides in assets/talks/ai-gamedev-2025/.

Design Philosophy

Typography-first. Emphasis comes from font weight and size, not color. The design is warm, readable, and optimized for projector display.

Whitespace does the work. Generous spacing, clean borders, no decoration. Every element earns its place.

One main visual per slide. Pick 1-2 components. Don't stack everything.


Color Palette

Backgrounds

VariableHexUse
--bg-base#f8f8f7Slide background (warm paper white)
--bg-surface#ffffffCards, elevated elements
--bg-muted#f0f0efSubtle backgrounds, code blocks

Text

VariableHexUse
--text-primary#1a1a1aMain text (near-black)
--text-secondary#555555Supporting text, descriptions
--text-tertiary#888888Meta, captions, annotations

Accent & Semantic

VariableHexUse
--accent#1a56dbLinks, highlights (use sparingly)
--positive#047857Good examples, success
--negative#b91c1cBad examples, warnings

Typography

Font Stacks

  • Sans-serif: System fonts (-apple-system, BlinkMacSystemFont, "Segoe UI", system-ui, sans-serif)
  • Monospace: "SF Mono", "Cascadia Code", "Consolas", monospace - for code, technical terms, file paths

Size Scale (responsive clamp values)

VariableUse
--text-megaSection titles, Q&A header
--text-hugeSlide titles (h1)
--text-largeSlide subtitles (h2)
--text-titleKey insight text, lead paragraphs
--text-bodyMain content, list items
--text-smallSecondary content, descriptions
--text-tinyMeta, sources, footnotes

Weight Usage

  • 400: Body text, descriptions
  • 500: Lead paragraphs, emphasis
  • 600: Headings (h2, h3)
  • 700: Main titles, strong emphasis
  • 800: Numbers, section titles

Spacing Scale

Use CSS custom properties:

code
--s1: 0.35rem    (tight)
--s2: 0.7rem     (small)
--s3: 1rem       (base)
--s4: 1.5rem     (medium)
--s5: 2rem       (large)
--s6: 2.5rem
--s7: 3rem
--s8: 4rem       (section breaks)

Component Library

When to Use Each

ComponentUse Case
key-insightOne main takeaway per slide (bordered box, centered)
calloutAnchor at bottom - summary or "so what"
big-list3-5 bullet points with bold leads
code-exampleCode snippets, file contents
quote-boxAttributed quotes
split-contentTwo-column comparisons
task-cardsGrid of related items (3x2)
design-loopSequential process (horizontal flow)
bold-statementPhilosophy/mindset slides (large centered text)
svg-diagramComplex flows, architecture
file-treeDirectory structures

Slide Structure Pattern

code
h2 (title)
  └── lead or key-insight (optional - pick one)
  └── main content (one component)
  └── callout (anchor/summary)

SVG Guidelines

Colors

  • Strokes: var(--text-tertiary) for lines, var(--text-primary) for emphasis
  • Fills: Usually none. Use var(--bg-muted) for boxes
  • Accent: var(--accent) for interactive/highlighted elements only

Line Weights

  • 1-1.5px for connection lines, arrows
  • 2px for box borders, emphasis
  • Use stroke-dasharray for optional/config elements

Hover States

css
.hoverable:hover .flow-box {
    stroke: var(--accent);
    stroke-width: 2;
}

Text in SVGs

  • .label-phase: 18px, bold, primary color (key stages)
  • .label-medium: 14px, mono, secondary (box labels)
  • .label-small: 15px, mono, secondary (inputs)
  • .label-desc: 11px, italic, tertiary (descriptions)

Layout Principles

  1. Vary visual treatment across a section - Avoid 3+ slides with same structure
  2. One main visual - Don't combine key-insight + big-list + diagram
  3. Callout anchors - Most slides end with a callout summary
  4. Responsive - Components stack vertically on mobile

Don'ts

  • No emojis - Use tasteful SVG icons if needed, or rely on typography
  • No color for emphasis - Use font-weight instead
  • No decorative elements - Everything serves communication
  • No stacking key-insight boxes - One per slide maximum
  • No pure black (#000) - Use near-black (#1a1a1a)
  • No generic icons - If using SVGs, they should be diagram elements, not decoration

Adding a New Slide

  1. Identify the one thing this slide communicates
  2. Pick one component that best conveys it
  3. Write the h2 title (clear, concise)
  4. Add lead text if needed for context
  5. Add callout to anchor the bottom
  6. Check: Does this look different from the previous 2 slides?

File Locations

  • HTML: assets/talks/ai-gamedev-2025/index.html
  • CSS: assets/talks/ai-gamedev-2025/style.css
  • JS: assets/talks/ai-gamedev-2025/slides.js
  • Images: assets/talks/ai-gamedev-2025/*.png