one-click-ai-ppt · diff
git:20260831.3042b26 to git:20260911.2c8bcb6
12 added, 2 removed. Audit A to A.
---
name: one-click-ai-ppt
description: Turn any topic into a complete business presentation — outline plus slide-by-slide speaker notes. Use when the user asks to create, generate, or draft a PPT, PowerPoint, slide deck, pitch deck, or presentation, or says "make me slides" / "give me a deck".
---
# One-Click AI PPT
Build a complete, presentation-ready business deck from a single topic. No external tools, no API keys — just structured thinking.
## When to use
- User asks for a PPT / PowerPoint / slide deck / pitch deck / presentation.
- User has a topic but no structure.
- User needs speaker notes or talking points for each slide.
## Workflow
### Step 1 — Clarify (ask only if truly missing)
Ask for: target audience, time limit (5/10/20 min), desired number of slides (default 10), and purpose (inform / persuade / pitch / report). If the user just says "make me a deck about X", proceed with sensible defaults: 10 slides, business audience, persuasive-informative mix. Do not block on questions the user already answered.
### Step 2 — Pick a structure
- Choose from references/slide-structures.md. Default: the 10-slide Business Pitch. Match the structure to the purpose:
+ Choose from the 16 structures in references/slide-structures.md, or use its "Choosing a structure" table. Default: the 10-slide Business Pitch. Match the structure to the purpose:
- Pitch / proposal → Problem → Solution → Market → Traction → Ask
- Status report → Wins → Metrics → Issues → Next steps
- Training / explainer → Concept → Why it matters → How it works → Examples → Practice
### Step 3 — Draft the outline
Produce a numbered slide list. Each slide gets a working title (a full sentence, not a noun phrase) and a one-line purpose.
### Step 4 — Write each slide
For every slide output:
- **Headline**: a claim or takeaway, not a label ("Q3 revenue grew 18% on enterprise renewals", not "Revenue").
- **3–5 bullet points max**, each under 12 words.
- **One visual suggestion** per slide (chart, diagram, screenshot, icon).
- **Speaker note**: 2–3 sentences the presenter can say out loud.
### Step 5 — Format the output
Use this Markdown template:
```
# <Deck title> (<N> slides, ~<M> min)
## Slide 1 — <Headline>
- ...
- ...
Visual: ...
Notes: ...
## Slide 2 — <Headline>
...
```
If the user wants a different format (table, JSON, plain text), follow their request.
## Copywriting rules
- Write in active voice. "We cut onboarding time by 40%", not "Onboarding time was reduced".
- Numbers first: lead with the metric, then the context.
- One idea per bullet. No nested bullets.
- Keep every sentence under ~15 words.
- No jargon the audience wouldn't use themselves.
- See references/copywriting-guide.md for before/after examples.
## Design guidance (pass along to the user)
- One message per slide; if a slide needs more than 5 bullets, split it.
- High-contrast text on a light background; avoid dark gradients.
- 24pt+ body text, 36pt+ headlines.
- Use one accent color for calls-to-action and key numbers.
- Charts beat tables; tables beat paragraphs.
+ - See references/design-guide.md for layout, type scale, colour and chart selection.
+ ## Language
+
+ Write in the language the user asks for. When the output is Chinese, also apply references/zh-cn-adaptation.md: larger type, full-width punctuation, conclusion-first headlines, no four-character filler.
+
## Edge cases
- Topic is vague ("something about marketing"): propose 3 concrete angles and let the user pick.
- - User wants another language: write in that language, keep the same structure.
+ - User wants another language: write in that language, keep the same structure. For Chinese, apply references/zh-cn-adaptation.md.
+ - User brings an existing deck to fix: audit it against the copywriting rules and return a corrected outline, keeping their own content.
- User wants a real .pptx file: provide the full outline plus slide text in a format they can paste into PowerPoint/Keynote/Google Slides, and offer the structure for a rendering script.
+
+ ## Examples
+
+ Worked decks live in examples/: examples/status-report.md, examples/investor-update.md, examples/training.md.