# Awesome PPT Design Skill

[繁體中文](README.md) | [English](README.en.md)

> One prompt, and Codex can generate a polished, presentation-ready PPT in a specific visual style.

Custom Codex skills for generating polished PowerPoint decks with [`ppt-master`](https://github.com/hugohe3/ppt-master).

This repository collects reusable PPT design skills. The goal is not to ship fixed templates, but to give agents a stable visual system to follow when creating decks: color, layout, typography, spacing, covers, charts, QA, and the PPT master workflow.

Traditional Chinese is supported. You can describe requirements, choose a style, set page count, and provide PDFs in Traditional Chinese. The skills are designed to understand Chinese deck narratives and presentation context.

```text
Use japanese-style-ppt-skill and follow ppt-master to create a 5-page PPT from this PDF.
請使用 minimalist-luxury-branding-ppt-skill，根據這份文件做一份 6 頁高端品牌提案簡報。
```

## Style Gallery

| Skill | Cover | Best For |
| --- | --- | --- |
| `japanese-style-ppt-skill` / Japanese Lifestyle Editorial | ![Japanese Lifestyle Editorial cover](japanese-style-ppt-skill/assets/examples/japanese-lifestyle-editorial/01_cover.svg) | Brand stories, business proposals, product narratives, magazine-style professional decks |
| `japanese-style-ppt-skill` / Washi Paper & Soft Glow | ![Washi Paper & Soft Glow cover](japanese-style-ppt-skill/assets/examples/washi-soft-glow/01_cover.svg) | Human-centered storytelling, warm business decks, brand philosophy, strategic narratives |
| `soft-3d-clay-ppt-skill` | ![Soft 3D Claymorphism cover](soft-3d-clay-ppt-skill/assets/examples/01_cover.svg) | Lightweight tech decks, friendly product explainers, lively but professional strategy decks |
| `futuristic-tech-editorial-ppt-skill` | ![Futuristic Tech Editorial cover](futuristic-tech-editorial-ppt-skill/assets/examples/01_cover.svg) | AI, platforms, engineering, technical strategy, data-forward business decks |
| `minimalist-luxury-branding-ppt-skill` | ![Minimalist Luxury Branding cover](minimalist-luxury-branding-ppt-skill/assets/examples/01_cover.svg) | Premium brand proposals, company profiles, founder decks, luxury business storytelling |
| `modern-illustration-editorial-ppt-skill` | ![Modern Illustration Editorial cover](modern-illustration-editorial-ppt-skill/assets/examples/01_cover.svg) | Product stories, strategy explainers, workflows, concept-led illustrated decks |
| `japanese-hand-drawn-editorial-ppt-skill` | ![Japanese Hand-Drawn Editorial cover](japanese-hand-drawn-editorial-ppt-skill/assets/examples/01_cover.svg) | Human-centered brands, lifestyle narratives, creative process, quiet concept-led decks |

## What You Can Make

| Capability | Output | Typical Use |
| --- | --- | --- |
| PDF to PPT | Multi-page decks rebuilt from source documents | Technical essays, research reports, product docs, business proposals |
| Style-directed deck | A complete visual system generated from a chosen skill | Quickly switch the same content across different visual moods |
| PPT master workflow | `design_spec.md`, `spec_lock.md`, SVG pages, PPTX export | Stable generation with inspectable production steps |
| Cover and visual QA | Each skill includes cover references and QA checklists | Keep colors, spacing, charts, and typography aligned |
| Traditional Chinese prompts | Traditional Chinese requirements and content organization | Chinese decks, Chinese business proposals, bilingual decks |

## Included Skills

### `japanese-style-ppt-skill`

A high-end Japanese editorial presentation system with two house styles.

**Washi Paper & Soft Glow**

- Off-white washi paper texture
- Soft glow and muted colors
- Thin gray lines with restrained indigo accents
- Generous negative space, quiet warmth

**Japanese Lifestyle Editorial**

- Stark white background
- Burnt orange and charcoal gray
- High-end lifestyle magazine composition
- Asymmetric edge-pressed imagery and structured grids

### `soft-3d-clay-ppt-skill`

Soft 3D / Claymorphism style.

- Warm beige `#FDF5E6`
- Sage green `#B2AC88`
- Morandi pink `#DBADAD`
- Soft matte geometric shapes
- Airy, modern, friendly, and still professional

### `futuristic-tech-editorial-ppt-skill`

Futuristic tech magazine style.

- White background `#FFFFFF`
- Electric blue `#2F6BFF`
- Graphite gray `#2B2B2B`
- Thin grids, data modules, asymmetric negative space
- No shadows, no 3D, flat and sharp

### `minimalist-luxury-branding-ppt-skill`

Minimalist luxury branding style.

- Warm beige `#F5EFE6`
- Soft brown `#A68A64`
- Deep gray text `#3A3A3A`
- Serif title plus sans-serif body typography
- Large margins, low density, premium rhythm

### `modern-illustration-editorial-ppt-skill`

Modern illustrated editorial presentation style.

- Soft beige `#F7F3EE`
- Muted blue `#A7C7E7`
- Dusty orange `#E8A87C`
- Charcoal gray `#2F2F2F`
- Refined vector illustration, slight gradients, restrained shadows

### `japanese-hand-drawn-editorial-ppt-skill`

Japanese hand-drawn editorial presentation style.

- Warm paper background `#F8F6F2`
- Ink black line art `#2B2B2B`
- Soft gray `#BDBDBD`
- Muted indigo `#6C7A89`
- Delicate pencil/ink illustration, pale watercolor fills, slightly imperfect strokes

## Quick Start

Copy the skill folders into your Codex skills directory, or keep them in a workspace Codex can read.

Use a prompt that names the skill and asks Codex to follow `ppt-master`:

```text
Use japanese-style-ppt-skill in the Washi Paper & Soft Glow style.
Follow ppt-master and create a 5-page PPT from this PDF.
```

```text
Use futuristic-tech-editorial-ppt-skill and follow ppt-master
to create a 3-page technical strategy PPT from this PDF.
```

```text
請使用 modern-illustration-editorial-ppt-skill，
把這份產品策略文件整理成 6 頁繁體中文簡報。
```

## PPT Master Workflow

When used with [`ppt-master`](https://github.com/hugohe3/ppt-master), treat each skill as the visual style layer and generate the deck through:

1. Content summary and slide plan
2. Eight Confirmations
3. `design_spec.md`
4. `spec_lock.md`
5. SVG pages
6. Visual QA
7. PPTX export

`ppt-master` can convert generated slide pages into editable `.pptx` files, so text, shapes, and layout can continue to be edited in PowerPoint instead of being exported only as static images.

Each skill provides:

- `SKILL.md`: trigger conditions and core style instructions
- `references/style-system.md`: color, typography, layout, chart, and image rules
- `references/slide-patterns.md`: reusable slide patterns
- `references/ppt-master-integration.md`: PPT master generation rules
- `references/qa-checklist.md`: final QA checklist
- `assets/examples/01_cover.svg`: style cover reference

## Design Principles

- Understand the content before applying style.
- Keep one clear message per slide.
- Treat color as a system, not decoration.
- Use negative space intentionally.
- Charts and illustrations must support the narrative.
- Covers, section slides, data slides, and closing slides should share one coherent visual language.
- Run the QA checklist before generating the final PPT.

## Repository Structure

```text
.
|-- japanese-style-ppt-skill/
|   |-- SKILL.md
|   |-- agents/openai.yaml
|   |-- assets/
|   |   |-- template.html
|   |   |-- style2-template.html
|   |   `-- examples/
|   |       |-- japanese-lifestyle-editorial/
|   |       `-- washi-soft-glow/
|   `-- references/
|       |-- style-system.md
|       |-- japanese-lifestyle-editorial.md
|       |-- slide-patterns.md
|       |-- ppt-master-integration.md
|       `-- qa-checklist.md
|-- soft-3d-clay-ppt-skill/
|   |-- SKILL.md
|   |-- agents/openai.yaml
|   |-- assets/
|   |   |-- template.html
|   |   `-- examples/
|   `-- references/
|       |-- style-system.md
|       |-- slide-patterns.md
|       |-- ppt-master-integration.md
|       `-- qa-checklist.md
|-- futuristic-tech-editorial-ppt-skill/
|   |-- SKILL.md
|   |-- agents/openai.yaml
|   |-- assets/
|   |   |-- template.html
|   |   `-- examples/
|   |       `-- 01_cover.svg
|   `-- references/
|       |-- style-system.md
|       |-- slide-patterns.md
|       |-- ppt-master-integration.md
|       `-- qa-checklist.md
|-- minimalist-luxury-branding-ppt-skill/
|   |-- SKILL.md
|   |-- agents/openai.yaml
|   |-- assets/
|   |   |-- template.html
|   |   `-- examples/
|   |       `-- 01_cover.svg
|   `-- references/
|       |-- style-system.md
|       |-- slide-patterns.md
|       |-- ppt-master-integration.md
|       `-- qa-checklist.md
|-- modern-illustration-editorial-ppt-skill/
|   |-- SKILL.md
|   |-- agents/openai.yaml
|   |-- assets/
|   |   |-- template.html
|   |   `-- examples/
|   |       `-- 01_cover.svg
|   `-- references/
|       |-- style-system.md
|       |-- slide-patterns.md
|       |-- ppt-master-integration.md
|       `-- qa-checklist.md
`-- japanese-hand-drawn-editorial-ppt-skill/
    |-- SKILL.md
    |-- agents/openai.yaml
    |-- assets/
    |   |-- template.html
    |   `-- examples/
    |       `-- 01_cover.svg
    `-- references/
        |-- style-system.md
        |-- slide-patterns.md
        |-- ppt-master-integration.md
        `-- qa-checklist.md
```

## Limits

- These skills define style and workflow, not fixed templates.
- Final quality still depends on source quality, page-count constraints, and PPT master execution.
- If formal brand guidelines exist, provide logos, color palettes, fonts, and brand documents first.
- Without brand assets, the built-in style systems act as fallback.