dokie-ai-ppt

What this skill does

# Dokie AI PPT Skill

This is Dokie AI PPT Skill — a professional presentation design skill. Use it whenever you need to generate a PPT, create a presentation, or build any showcase content with HTML.

Built on web technologies, supporting everything from minimal business style to Awwwards-level creative motion — far beyond what traditional PPT can deliver.

## Prerequisites

```bash
npx dokie-cli themes    # Verify CLI is available
```

## Workflow

**⚠️ IMPORTANT: This is an interactive, step-by-step workflow. At each step, you MUST read the referenced rule files before doing the work. Present your result to the user and wait for their response before moving to the next step. Do NOT rush through multiple steps in one response.**

### New Project

```
Collect requirements → User confirms → Select theme → User confirms → Generate outline → User confirms → Generate HTML → Preview → User feedback
```

### Modify Project

```
Understand intent → Minimal changes → Preserve original layout
```

See [rules/workflow.md](rules/workflow.md) for details.

## Core Specifications

| Item | Specification |
|------|---------------|
| Resolution | 1280 × 720 |
| Charts | Chart.js 4.5 |
| Icons | Font Awesome 6.5 |
| Animation | GSAP (CSS animation prohibited) |
| Prohibited | Emoji, fabricated image URLs |

## Rule Index

### Process & Format

| File | Content | When to Reference |
|------|---------|-------------------|
| [workflow.md](rules/workflow.md) | Full workflow, grouping rules, theme switching | Before starting a task |
| [outline.md](rules/outline.md) | Outline format (Content + Design) | When generating outline |
| [modify-scenarios.md](rules/modify-scenarios.md) | Modification scenarios (insert, delete, split, merge, restyle, etc.) | When modifying a project |
| [quality-check.md](rules/quality-check.md) | Post-generation quality checklist | After generation, before preview |

### Theme & Generation

| File | Content | When to Reference |
|------|---------|-------------------|
| [theme.md](rules/theme.md) | Theme structure, style extraction, generation steps | **Must read before generating HTML** |
| [theme-list.md](rules/theme-list.md) | Full theme list (local + online) | When selecting a theme |
| [theme-customize.md](rules/theme-customize.md) | Change colors, fonts, custom themes | When user requests customization |
| [slide-html.md](rules/slide-html.md) | HTML specs, icons, image rules | When generating HTML |

### Charts

| File | Content |
|------|---------|
| [charts/chartjs.md](rules/charts/chartjs.md) | Statistical charts (bar, line, pie, radar, bubble) |
| [charts/pyramid.md](rules/charts/pyramid.md) | Pyramid chart (HTML + CSS clip-path) |
| [charts/funnel.md](rules/charts/funnel.md) | Funnel chart (HTML + CSS clip-path) |
| [charts/timeline.md](rules/charts/timeline.md) | Timeline (HTML + CSS Flex/Grid) |
| [charts/flowchart.md](rules/charts/flowchart.md) | Flowchart + cycle diagram (HTML/AntV/Mermaid) |
| [charts/quadrant.md](rules/charts/quadrant.md) | Quadrant / SWOT (HTML + CSS Grid) |

### Animation

Choose style based on scenario. Default is "Balanced":

| File | Style | Use Case |
|------|-------|----------|
| [animation/minimal.md](rules/animation/minimal.md) | Minimal | Formal business, investor presentations |
| [animation/balanced.md](rules/animation/balanced.md) | Balanced | General purpose, internal training |
| [animation/creative.md](rules/animation/creative.md) | Creative | Product launches, creative showcases |

## CLI Commands

```bash
npx dokie-cli themes                      # List all themes
npx dokie-cli themes --json               # JSON format output
npx dokie-cli theme <name|id>             # Get theme details (with HTML templates)
npx dokie-cli theme "Dokie Vibe" --json   # JSON format output
npx dokie-cli preview ./my-project/       # Local preview
```

## Output Format

```
my-project/
├── slide_01.html
├── slide_02.html
├── slide_03.html
└── ...
```

File naming: `slide_01.html`, `slide_02.html` ... numbered sequentially.

## Key Constraints

1. **Strictly follow the outline** — do not modify, expand, or abbreviate
2. **Theme consistency** — colors, fonts, styles must strictly follow the theme
3. **Content density** — one topic per slide, split if too much
4. **Image sources** — only use user-uploaded or tool-fetched images
5. **Data integrity** — never fabricate chart data