Humanize PPT
Use this skill when a user wants to turn raw material, notes, voice transcripts, documents, links, or old PPTs into a presentation-ready outline before rendering slides.
Positioning
Humanize PPT is an Outline Director and Agent Teams Orchestrator, not a slide renderer.
It should run before downstream PPT / HTML slide skills. Its job is to produce a clean AST-based production brief so renderers do not ingest raw noisy material directly.
In Agent Teams mode, the main Humanize PPT Agent loads this skill and controls specialist agents:
- Guizang Agent for Chinese stable rendering.
- Zara Agent for style exploration, HTML production, and deploy.
- HyperFrames Agent for video slots.
- Presenter Agent for presenter mode after the deck is finalized.
- QA Agent for content, visual, path, and delivery checks.
AST theory
AST means Audience-State-Transfer.
- Audience: who is listening, what they know, what they resist, and why they would keep listening.
- State: the audience state before and after the deck, plus the core tension that blocks the transition.
- Transfer: the slide-by-slide path that moves the audience from initial state to desired state.
Core sentence:
PPT is not an information container. PPT is an audience state-transfer artifact.
Required output contract
For every Humanize PPT run, produce:
deck_brief.md — audience, goal, tension, success criteria.
ast_outline.md — AST map and narrative arc.
slide_plan.json — slide-by-slide plan.
speaker_intent.md — what the speaker should do on each slide.
asset_manifest.md — screenshots, charts, images, video needs.
video_slots.json — optional HyperFrames / video insertion plan.
Recommended OPC workflow
O — Outline Director
Humanize PPT: raw material → AST outline + production brief
P — Presentation Production
guizang path: Chinese stable HTML PPT
Zara path: style exploration and HTML production
C — Complete / Control
HyperFrames video adapter
Presenter Adapter shell
Deploy / export adapter
QA checklist
Rules
- Do not let slide renderers consume raw material directly when Humanize PPT can first produce the AST contract.
- Keep presenter mode as a post-processing adapter, not a style.
- Separate deployment from presenter mode.
- Absorb AI-writing cleanup principles from humanizer tools, but do not reduce Humanize PPT to text polishing.
- Prefer a small verified workflow over a broad unverified promise.
- For public Skill releases, create/push the repo, install from GitHub locally, run one safe full sample, verify style exploration + presenter mode + deploy URL, and only then polish README details.
- For Agent Teams development, emit
router_plan.json, run_manifest.json, bounded commands/*.md, and separate outputs/<agent>/ directories before wiring real downstream Skills.
Operational references
references/agent-teams-public-preview.md — Agent Teams architecture, specialist-agent command protocol, public preview release loop, and README split convention.
Local demo
If this repository is installed locally, run:
python3 scripts/humanize_ppt_v1.py \
--source examples/01-ai-tool-update/source.md \
--out .humanize-ppt-runs/ai-tool-update \
--title "AI 工具更新,不只是功能清单"
1---
2name: humanize-ppt
3description: AST-based outline director for human-centered AI presentation workflows. Use before generating PPT/HTML slides from raw material.
4version: 0.1.0
5author: LearnPrompt
6license: MIT
7metadata:
8 source: https://skillmd.com/skills/ahang1598/humanize-ppt
9 tags: [presentation, ppt, html-slides, humanizer, ast, workflow]
10---
11
12# Humanize PPT
13
14Use this skill when a user wants to turn raw material, notes, voice transcripts, documents, links, or old PPTs into a presentation-ready outline before rendering slides.
15
16## Positioning
17
18Humanize PPT is an **Outline Director** and **Agent Teams Orchestrator**, not a slide renderer.
19
20It should run before downstream PPT / HTML slide skills. Its job is to produce a clean AST-based production brief so renderers do not ingest raw noisy material directly.
21
22In Agent Teams mode, the main Humanize PPT Agent loads this skill and controls specialist agents:
23
24- Guizang Agent for Chinese stable rendering.
25- Zara Agent for style exploration, HTML production, and deploy.
26- HyperFrames Agent for video slots.
27- Presenter Agent for presenter mode after the deck is finalized.
28- QA Agent for content, visual, path, and delivery checks.
29
30## AST theory
31
32AST means **Audience-State-Transfer**.
33
34- **Audience**: who is listening, what they know, what they resist, and why they would keep listening.
35- **State**: the audience state before and after the deck, plus the core tension that blocks the transition.
36- **Transfer**: the slide-by-slide path that moves the audience from initial state to desired state.
37
38Core sentence:
39
40> PPT is not an information container. PPT is an audience state-transfer artifact.
41
42## Required output contract
43
44For every Humanize PPT run, produce:
45
461. `deck_brief.md` — audience, goal, tension, success criteria.
472. `ast_outline.md` — AST map and narrative arc.
483. `slide_plan.json` — slide-by-slide plan.
494. `speaker_intent.md` — what the speaker should do on each slide.
505. `asset_manifest.md` — screenshots, charts, images, video needs.
516. `video_slots.json` — optional HyperFrames / video insertion plan.
52
53## Recommended OPC workflow
54
55```text
56O — Outline Director
57 Humanize PPT: raw material → AST outline + production brief
58
59P — Presentation Production
60 guizang path: Chinese stable HTML PPT
61 Zara path: style exploration and HTML production
62
63C — Complete / Control
64 HyperFrames video adapter
65 Presenter Adapter shell
66 Deploy / export adapter
67 QA checklist
68```
69
70## Rules
71
721. Do not let slide renderers consume raw material directly when Humanize PPT can first produce the AST contract.
732. Keep presenter mode as a post-processing adapter, not a style.
743. Separate deployment from presenter mode.
754. Absorb AI-writing cleanup principles from humanizer tools, but do not reduce Humanize PPT to text polishing.
765. Prefer a small verified workflow over a broad unverified promise.
776. For public Skill releases, create/push the repo, install from GitHub locally, run one safe full sample, verify style exploration + presenter mode + deploy URL, and only then polish README details.
787. For Agent Teams development, emit `router_plan.json`, `run_manifest.json`, bounded `commands/*.md`, and separate `outputs/<agent>/` directories before wiring real downstream Skills.
79
80## Operational references
81
82- `references/agent-teams-public-preview.md` — Agent Teams architecture, specialist-agent command protocol, public preview release loop, and README split convention.
83
84## Local demo
85
86If this repository is installed locally, run:
87
88```bash
89python3 scripts/humanize_ppt_v1.py \
90 --source examples/01-ai-tool-update/source.md \
91 --out .humanize-ppt-runs/ai-tool-update \
92 --title "AI 工具更新,不只是功能清单"
93```