Files
skills/pptx-generator/references/design-system.md
shihao 6487becf60 Initial commit: add all skills files
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-10 16:52:49 +08:00

16 KiB

Design System

Color Palette Reference

# Name Colors Style Use Cases Tips
1 Modern & Wellness #006d77 #83c5be #edf6f9 #ffddd2 #e29578 Fresh, soothing Healthcare, counseling, skincare, yoga/spa Deep teal for titles, light pink for background
2 Business & Authority #2b2d42 #8d99ae #edf2f4 #ef233c #d90429 Formal, classic Annual reports, financial analysis, corporate intro, government Deep blue for professionalism, bright red to highlight data
3 Nature & Outdoors #606c38 #283618 #fefae0 #dda15e #bc6c25 Grounded, earthy Outdoor gear, environmental, agriculture, historical culture Dark green base, cream text
4 Vintage & Academic #780000 #c1121f #fdf0d5 #003049 #669bbc Classic, scholarly Academic lectures, history reviews, museums, heritage brands Strong contrast between deep red and deep blue
5 Soft & Creative #cdb4db #ffc8dd #ffafcc #bde0fe #a2d2ff Dreamy, candy-toned Mother & baby, desserts, women's fashion, kindergarten Use dark gray or black for text
6 Bohemian #ccd5ae #e9edc9 #fefae0 #faedcd #d4a373 Gentle, muted Wedding planning, home decor, organic food, slow living Cream background, green-brown accents
7 Vibrant & Tech #8ecae6 #219ebc #023047 #ffb703 #fb8500 High energy, sporty Sports events, gyms, startup pitches, youth education Deep blue for stability, orange as focal accent
8 Craft & Artisan #7f5539 #a68a64 #ede0d4 #656d4a #414833 Rustic, coffee-toned Coffee shops, handicrafts, traditional culture, bakery Suited for paper/leather textures
9 Tech & Night #000814 #001d3d #003566 #ffc300 #ffd60a Deep, luminous Tech launches, astronomy, night economy, luxury automobiles Must use dark mode
10 Education & Charts #264653 #2a9d8f #e9c46a #f4a261 #e76f51 Clear, logical Statistical reports, education, market analysis, general business Perfect chart color scheme
11 Forest & Eco #dad7cd #a3b18a #588157 #3a5a40 #344e41 Monochrome gradient, forest Landscape design, ESG reports, environmental causes, botanical Monochrome palette is safe and cohesive
12 Elegant & Fashion #edafb8 #f7e1d7 #dedbd2 #b0c4b1 #4a5759 Muted, Morandi tones Haute couture, art galleries, beauty brands, magazine style Negative space is key
13 Art & Food #335c67 #fff3b0 #e09f3e #9e2a2b #540b0e Rich, vintage-poster Food documentaries, art exhibitions, ethnic themes, vintage restaurants Works well with large color blocks
14 Luxury & Mysterious #22223b #4a4e69 #9a8c98 #c9ada7 #f2e9e4 Cool, purple-toned Jewelry showcases, hotel management, high-end consulting, psychology Purple evokes premium atmosphere
15 Pure Tech Blue #03045e #0077b6 #00b4d8 #90e0ef #caf0f8 Futuristic, clean Cloud/AI, water/ocean, hospitals, clean energy Deep ocean to sky gradient
16 Coastal Coral #0081a7 #00afb9 #fdfcdc #fed9b7 #f07167 Refreshing, summery Travel, summer events, beverage brands, ocean themes Teal and coral as complementary focal colors
17 Vibrant Orange Mint #ff9f1c #ffbf69 #ffffff #cbf3f0 #2ec4b6 Bright, cheerful Children's events, promotional posters, FMCG, social media Orange grabs attention, mint feels fresh
18 Platinum White Gold #0a0a0a #0070F3 #D4AF37 #f5f5f5 #ffffff Premium, professional Agent products, corporate websites, fintech, luxury brands White-gold base, blue for action, gold for emphasis

Agent Design System — Full Color Scale

Based on the Platinum White-Gold Theme design tokens. Provides complete color scales for fine-grained design work.

White Scale (Backgrounds & Light Surfaces)

Token Value Usage
white-0 #ffffff Primary background
white-50 #fefefe Slightly warm white
white-75 #fcfcfc Near-white
white-100 #fafafa Secondary background
white-200 #f7f7f7 Card background
white-300 #f5f5f5 Tertiary background
white-400 #f0f0f0 Separator zones
white-500 #ebebeb Light border
white-600 #e5e5e5 Disabled background
white-700 #e0e0e0 Deep white-gray
white-800 #d9d9d9 Placeholder
white-900 #d4d4d4 Divider lines
white-1000 #cccccc Deepest white

Gold Scale (Platinum Business Accent)

Token Value Usage
gold-25 #FFFDF5 Extremely light gold background
gold-50 #FEF9E7 Light gold background
gold-75 #FCF3D0 Pale gold highlight
gold-100 #FAECB8 Gold hover state
gold-200 #F5DC8A Bright gold accent
gold-300 #E8C860 Gold hover
gold-400 #D4AF37 Primary gold (core)
gold-500 #B8972E Gold text
gold-600 #9A7E26 Deep gold accent
gold-700 #7C651E Dark gold border
gold-800 #5E4C16 Deep gold background
gold-900 #40330F Very deep gold
gold-1000 #221A08 Black gold

Blue Scale (Primary Action Color)

Token Value Usage
blue-25 #F0F7FF Extremely light blue background
blue-50 #E0EFFF Info alert background
blue-75 #C2DFFF Light blue highlight
blue-100 #A3CFFF Disabled blue
blue-200 #66AFFF Bright blue
blue-300 #338FFF Blue hover
blue-400 #0070F3 Primary blue (core)
blue-500 #005FCC Blue text
blue-600 #004FA6 Deep blue accent
blue-700 #003F80 Dark blue border
blue-800 #002F5A Deep blue background
blue-900 #001F3D Very deep blue
blue-1000 #001026 Black blue

Gray Scale (Text & Neutral Colors)

Token Value Usage
gray-0 #ffffff White
gray-50 #fafafa Extremely light gray
gray-75 #f5f5f5 Light gray background
gray-100 #ededed Light divider
gray-200 #d4d4d4 Light border
gray-300 #a3a3a3 Quaternary text
gray-400 #737373 Tertiary text
gray-500 #525252 Secondary text
gray-600 #404040 Dark gray
gray-700 #2e2e2e Dark background
gray-800 #1f1f1f Deep background
gray-900 #141414 Very deep background
gray-1000 #0a0a0a Primary text (core)

Opacity Values

Opacity Black
Opacity Value Usage
0% #0a0a0a00 Fully transparent
2% #0a0a0a05 Subtle overlay
4% #0a0a0a0a Secondary interactive background
8% #0a0a0a14 Border / divider
15% #0a0a0a26 Pressed state
20% #0a0a0a33 Light overlay
25% #0a0a0a40 Medium overlay
50% #0a0a0a80 Semi-transparent
70% #0a0a0ab2 Deep overlay
80% #0a0a0acc Hover state
90% #0a0a0ae5 Tooltip
95% #0a0a0af2 Modal
Opacity White
Opacity Value Usage
0% #ffffff00 Fully transparent
2% #ffffff05 Subtle overlay
4% #ffffff0a Secondary interactive background
8% #ffffff12 Border / divider
15% #ffffff26 Pressed state
20% #ffffff33 Light overlay
25% #ffffff40 Medium overlay
50% #ffffff80 Semi-transparent
70% #ffffffb2 Deep overlay
80% #ffffffcc Hover state
90% #ffffffe5 Tooltip
95% #fffffff2 Modal

Color Palette Rules (MANDATORY)

Strict Palette Adherence

Use ONLY the provided color palette. Do NOT create or modify colors.

  • All colors must come from the user-provided palette
  • Do NOT use colors outside the palette
  • Do NOT modify palette colors (brightness, saturation, mixing)
  • Only exception: Add transparency using the transparency property (0-100)
// Correct: Using palette colors
slide.addShape(pres.shapes.RECTANGLE, { fill: { color: theme.primary } });
slide.addText("Title", { color: theme.accent });

// Wrong: Colors outside palette
slide.addShape(pres.shapes.RECTANGLE, { fill: { color: "1a1a2e" } });

No Gradients

Gradients are prohibited. Use solid colors only.

No Animations

Animations and transitions are prohibited. All slides must be static.


Font Reference

Language Default Font Alternatives
Chinese Microsoft YaHei
English Arial Georgia, Calibri, Cambria, Trebuchet MS
  • For mixed Chinese-English content: use Microsoft YaHei for Chinese, the chosen font for English
  • Prefer system fonts for cross-platform compatibility
  • Titles and body text can use different font pairings (e.g. Georgia + Calibri)
Header Font Body Font
Georgia Calibri
Arial Black Arial
Calibri Calibri Light
Cambria Calibri
Trebuchet MS Calibri
Impact Arial
Palatino Garamond
Consolas Calibri

Choose an interesting font pairing — don't default to Arial for everything. Pick a header font with personality and pair it with a clean body font.

No Bold for Body Text

Plain body text and caption/legend text must NOT use bold.

  • Body paragraphs, descriptions → normal weight
  • Captions, legends, footnotes → normal weight
  • Reserve bold for titles and headings only
// Correct
slide.addText("Main Title", { bold: true, fontSize: 36, fontFace: "Arial" });
slide.addText("Body text here.", { bold: false, fontSize: 14, fontFace: "Arial" });

// Wrong
slide.addText("Body text here.", { bold: true, fontSize: 14 });

Style Recipes

The same design can be rendered in 4 distinct visual styles by adjusting corner radius (rectRadius) and spacing. Choose the style recipe that fits the presentation tone.

Unit note: PptxGenJS uses inches. Slide dimensions are 10" x 5.625" (LAYOUT_16x9).

Style Overview

Style Corner Radius Spacing Best For
Sharp & Compact 0 ~ 0.05" Tight Data-dense, tables, professional reports
Soft & Balanced 0.08" ~ 0.12" Moderate Corporate, business presentations, general use
Rounded & Spacious 0.15" ~ 0.25" Relaxed Product intros, marketing, creative showcases
Pill & Airy 0.3" ~ 0.5" Open Brand showcases, launch events, premium presentations

Sharp & Compact

Visual character: Geometric, high information density, formal and serious.

Category Value (inches) Notes
Corner radius — small 0" Full right angle
Corner radius — medium 0.03" Micro-rounded
Corner radius — large 0.05" Slight rounding
Element padding 0.1" ~ 0.15" Compact
Element gap 0.1" ~ 0.2" Compact
Page margin 0.3" Narrow
Block gap 0.25" ~ 0.35" Compact

Soft & Balanced

Visual character: Moderate rounding, comfortable whitespace, professional yet approachable.

Category Value (inches) Notes
Corner radius — small 0.05" Slight rounding
Corner radius — medium 0.08" Medium rounding
Corner radius — large 0.12" Larger rounding
Element padding 0.15" ~ 0.2" Moderate
Element gap 0.15" ~ 0.25" Moderate
Page margin 0.4" Standard
Block gap 0.35" ~ 0.5" Moderate

Rounded & Spacious

Visual character: Large corners, generous whitespace, friendly and modern.

Category Value (inches) Notes
Corner radius — small 0.1" Medium rounding
Corner radius — medium 0.15" Large rounding
Corner radius — large 0.25" Very large rounding
Element padding 0.2" ~ 0.3" Relaxed
Element gap 0.25" ~ 0.4" Relaxed
Page margin 0.5" Wide
Block gap 0.5" ~ 0.7" Relaxed

Pill & Airy

Visual character: Full pill-shaped corners, abundant whitespace, light and open feel, strong brand presence.

Category Value (inches) Notes
Corner radius — small 0.2" Large rounding
Corner radius — medium 0.3" Pill shape
Corner radius — large 0.5" Full pill
Element padding 0.25" ~ 0.4" Open
Element gap 0.3" ~ 0.5" Open
Page margin 0.6" Wide
Block gap 0.6" ~ 0.9" Open

Component Style Mapping

Component Sharp Soft Rounded Pill
Button / Tag rectRadius: 0 rectRadius: 0.05 rectRadius: 0.1 rectRadius: 0.2
Card / Container rectRadius: 0.03 rectRadius: 0.1 rectRadius: 0.2 rectRadius: 0.3
Image Container rectRadius: 0 rectRadius: 0.08 rectRadius: 0.15 rectRadius: 0.25
Input Field rectRadius: 0 rectRadius: 0.05 rectRadius: 0.1 rectRadius: 0.2
Badge rectRadius: 0.02 rectRadius: 0.05 rectRadius: 0.08 rectRadius: 0.15
Avatar Frame rectRadius: 0 rectRadius: 0.1 rectRadius: 0.2 rectRadius: 0.5 (circle)

PptxGenJS Corner Radius Examples

// Sharp style card
slide.addShape("rect", {
  x: 0.5, y: 1, w: 4, h: 2.5,
  fill: { color: "F5F5F5" },
  rectRadius: 0.03
});

// Rounded style card
slide.addShape("rect", {
  x: 0.5, y: 1, w: 4, h: 2.5,
  fill: { color: "F5F5F5" },
  rectRadius: 0.2
});

// Pill style button (height 0.4", rectRadius 0.2" = perfect pill)
slide.addShape("rect", {
  x: 3, y: 4, w: 2, h: 0.4,
  fill: { color: "4A90D9" },
  rectRadius: 0.2
});

Mixing Rules

1. Outer container corner >= inner element corner

// Correct: outer > inner
card:   rectRadius: 0.2
button: rectRadius: 0.1

// Wrong: inner > outer → visual overflow effect
card:   rectRadius: 0.1
button: rectRadius: 0.2

2. Information density drives spacing

Zone Type Recommended Style
Data display zone Sharp / Soft (compact spacing)
Content browsing zone Rounded / Pill (relaxed spacing)
Title zone Soft / Rounded (moderate spacing)

3. Corner radius vs element height

Element Height Sharp Soft Rounded Pill
Small (< 0.3") 0" 0.03" 0.08" height/2
Medium (0.3" ~ 0.6") 0.02" 0.05" 0.12" height/2
Large (0.6" ~ 1.2") 0.03" 0.08" 0.2" 0.3"
Extra large (> 1.2") 0.05" 0.12" 0.25" 0.4"

Pill tip: For a perfect pill shape, set rectRadius = element height / 2

Typography Scale (PPT)

Usage Size (pt) Notes
Annotations / Sources 10 ~ 12 Minimum readable size
Body / Description 14 ~ 16 Standard body
Subtitle 18 ~ 22 Secondary heading
Title 28 ~ 36 Page title
Large Title 44 ~ 60 Cover / section title
Data Callout 60 ~ 96 Key number display

Spacing Scale (PPT)

Based on 10" x 5.625" slide dimensions:

Usage Recommended (inches)
Icon-to-text gap 0.08" ~ 0.15"
List item spacing 0.15" ~ 0.25"
Card inner padding 0.2" ~ 0.4"
Element group gap 0.3" ~ 0.5"
Page safe margin 0.4" ~ 0.6"
Major block gap 0.5" ~ 0.8"

Quick Selection Guide

Presentation Type Recommended Style Reason
Finance / Data reports Sharp & Compact High density, serious and precise
Corporate / Business Soft & Balanced Balances professionalism and approachability
Product intro / Marketing Rounded & Spacious Modern feel, friendly
Launch events / Brand Pill & Airy Premium feel, visual impact
Training / Education Soft / Rounded Clear, readable, friendly
Tech sharing Sharp / Soft Professional, information-dense