It is not "help you with layout and polish", but a production line from scenario understanding to finished delivery. Core creed (inherited from ppt-designer):The essence of PPT is information delivery; design serves the content.
Iron rules (not suggestions)
- Outline first, then everything else. Visual image mode (Mode C) must start only after the outline has been confirmed by the user; the image model is only responsible for "drawing the already-defined pages" and never decides what the deck talks about. When the user asks to "skip the outline and draw directly", explain why and provide the outline first.
- Each page first has a page brief, then an image prompt, skipping levels is prohibited.
- One deck, one style. Style parameters are uniformly injected into each page from the style brief; page-by-page drift is not allowed.
Acceptance criteria (self-check item by item before delivery)
- The outline exists before any page is produced and has been confirmed by the user (except Mode A, which is itself the endpoint)
- Each page conforms to the required fields of the page schema, and density is compliant (3-5 key points / levels ≤3 / font size ratio ≥2:1)
- The whole set uses the same style brief; any two pages taken at random have consistent fonts, color palette, and layout code
- Each page prompt in Mode C includes the style name, composition, title copy, body copy, and prohibited items
- Deliverables include speaker notes (except when the user explicitly does not want them)
- No emoji used as functional icons; the color scheme comes from the selected style palette rather than improvisation
What we do not do
- Technical operations on pptx files (splitting/merging/page count statistics) → host environment pptx skill
- In-depth writing of speeches and article body text →
wechat-article-writer - When the content requires multi-source research → first hand off to
deep-research, then return to this process once the conclusions are obtained - Single poster, logo, purely decorative image → handled directly by image generation skills
- When the user only wants "just a few usable pages, anything is fine", compress it to: quick outline → Mode B simplified output, without going through the full six steps
Workflow (six steps)
Step 1 Identify the task type
Report / pitch / training / proposal / retrospective / consulting report / recruitment introduction / self-media sharing.
For judgment rules see references/scene-routing.md. When identification is uncertain, ask directly; do not guess.
Step 2 Fill in the key context (ask at most 5 items; do not repeat asking about what is already known)
① Who is it for ② What is the goal ③ Expected page count ④ Preference for content clarity or visual impact ⑤ Whether a style/brand color is specified
Step 3 Choose the style
User-specified → lock it. Not specified → recommend 3 according to the "scenario × style" matrix in references/scene-routing.md and give a one-sentence reason for each.
If the user has brand assets (ChaoGeek / ClawTime / WorkBuddy) → directly use style-library/custom/ custom style.
Step 4 Produce the outline (Mode A stops here)
According to templates/outline-template.md: topic / audience / goal / suggested page count / title for each page + one-sentence summary.
Stop and wait for user confirmation before continuing.
Step 5 Page-level structure
Fill in the page schema page by page (references/page-schema.md): page type, core conclusion, visual structure, content modules, image requirements.
Step 6 Deliver by Mode
| Mode | Applicable | Output |
|---|---|---|
| A. Outline | User hasn't figured out the content yet | Outline (Step 4 artifact) |
| B. Content Draft | Hand off to a PPT generator/front-end engine, or use PptxGenJS to directly produce pptx | slide schema JSON + readable Markdown + style parameters; for the PptxGenJS route see references/v2-pipeline/pptx-generation.md |
| C. Visual Images | Generate images page by page (image model), or an infographic image set | Each page: page brief → image prompt → image generation; for the process and engine adaptation see references/image-branch.md |
Style Library (style-library/, currently 13, continuously expanding)
| Category | Style | One-liner |
|---|---|---|
| General Business | business/moshiro-consulting.md Ink White Consulting |
Black, white, gray + a single accent color, the restrained feel of a consulting report |
| General Business | business/heibai-ledger.md Black-and-White Ledger |
A data-reporting style where tables and numbers are the stars (default for Mode B) |
| Brand Creative | creative/yinghuang-studio.md British Yellow Studio |
Black + warm yellow, a high-end proposal feel, large type with generous whitespace |
| Brand Creative | creative/tanghe-frame.md Candy Box Color Frame |
Cream background + colorful block borders, a trendy magazine feel |
| Education & Training | education/qingfeng-classroom.md Breeze Lecture Hall |
Water-blue and refreshing, a low-pressure courseware feel |
| Education & Training | education/academic-bluegray.md Academic Blue-Gray |
For thesis defenses and academic reports (default for Mode B) |
| Tech Future | tech/polar-night.md Polar Night Tech |
Dark background with neon, for AI/data product launches |
| Tech Future | tech/platinum-future.md Platinum Gray Future |
Light metallic texture, projection-friendly tech feel |
| Content Distribution | media/hot-card.md Hot Post Card |
Xiaohongshu-style high-contrast card image set |
| Content Distribution | media/notion-handdrawn.md Notion Hand-Drawn |
v2 signature: hand-drawn lines + sticky-note texture knowledge infographics |
| Custom Brand | custom/chaogeek-pixel.md ChaoGeek Pixel Halftone |
Neon green/lobster red/dark background DNA, derived from the chaogeek visual system |
| Custom Brand | custom/clawtime-industrial.md ClawTime Black-Red Industrial |
Carbon black + mechanical red, an industrial interlocking feel (first draft pending brand calibration) |
| Custom Brand | custom/workbuddy-modern.md WorkBuddy Green Modern |
Productivity green, an efficiency-tool official website feel (first draft pending brand calibration) |
Selection rule: first match the scenario by category, then exclude based on the "unsuitable scenarios" in the style file. Each style file contains 10 fields (color palette/typography temperament/layout/image strategy/density/style brief, etc.).
Known Pitfalls
| Pitfall | Specific Manifestation | Response |
|---|---|---|
| Skipping the outline and going straight to pages | The user urges "just draw it," and the logic of the entire deck falls apart | Iron rule 1: after explaining, provide the outline first; the cost of confirming an outline is far lower than rework |
| Style drift from page to page | Page 8 suddenly switched its color scheme and fonts | Each page's prompt is injected from the same style brief; spot-check any two pages |
| Chinese typography fails in image models | Overlapping text, text pressing on images, garbled pseudo-Chinese characters | Prompts must include Chinese typography prohibitions; for long text, switch to the "leave text space in the image, overlay text afterward" strategy, see image-branch.md |
| Looks good but is hard to present | Visually striking pages have too low density; a page with 3 minutes of talk has no content | The page schema's key_message is required; speaker notes are produced in sync |
| Single-page information overload | 6+ key points, 3 charts crammed onto one page | Hard density rule constraint: split the page |
| Style recommendations are homogeneous | The 3 recommended styles look indistinguishable | The 3 recommendations must come from ≥2 categories |
Reference documents (load on demand)
| File | When to read |
|---|---|
references/page-schema.md |
When defining pages one by one in Step 5 |
references/scene-routing.md |
During Step 1 identification and Step 3 recommendation |
references/image-branch.md |
When starting Mode C; engine adaptation (gpt-image / seedream / skywork) and Chinese typography prohibitions |
references/layout-rules.md |
When unsure about typography details; the full theory of CRAP/hierarchy/color/image (inherited from ppt-designer) |
references/quick-reference.md |
Look up numerical specifications anytime during production (font size/spacing/color values) |
references/case-examples.md |
When a full set of style scheme references is needed; three cases: business/creative/academic |
templates/outline-template.md |
Step 4 |
templates/page-brief-template.md |
Step 5 |
templates/image-prompt-template.md |
When producing prompts page by page in Mode C |
v2 legacy (references/v2-pipeline/, implementation details of Modes B/C, use on demand)
pptx-generation.md— Complete PptxGenJS programmatic generation solution (the implementation of Mode B directly outputting pptx)design-system.md— v2 design system (tokens/components, the default visual parameters of Mode B)style-guide.md— v2 style definitions such as Notion hand-drawn style (to be refactored into style-library format)aesthetic-design.md— Aesthetic design notesresearch-notes-format.md/subagent-prompt.md— Sub-agent parallel research protocol (when the outline needs data gathering)v2-prompt-template.md— v2 infographic prompt template (hand-drawn style parameters not covered by the new template can be taken from here)v2-skill-archive.md— Archived original SKILL.md of notion-infographic v2
Regression
evals/routing-evals.json— Trigger/mode routing use cases; after changing description, use the repository rootscripts/run_routing_evals.pyto validate