SuperAPI AI Directory

Geek-skills-deck-studio

General & other

View repository

Updated 10-16 09:30

About this skill

Deck Studio: PPT production Agent

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)

  1. 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.
  2. Each page first has a page brief, then an image prompt, skipping levels is prohibited.
  3. 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 notes
  • research-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 root scripts/run_routing_evals.py to validate