nexu-io/open-design / plugins/community/humanize-ppt
humanize-ppt
VerifiedA presentation system for agent-made PPTs — born for the talk, not just the template. It turns raw material into an AST (audience-state-transfer) outline with per-page visual-enhancement decisions (image / SVG diagram / video), hands a production brief to a downstream renderer (HTML-PPT skills or native PPTX), then runs a capped 3-round presentation checkup (演讲体检) on the rendered deck. It never renders slides itself. Use before generating PPT/HTML slides from raw material, and after rendering when the user says things like "给这份 deck 做演讲体检" or "PPT 渲染质检". If all you want is one beautiful template page with no outline and no checkup, a rendering skill alone is enough.
references/beautiful-preview-first-adapter.md
View on GitHub# Beautiful Preview-First Adapter Notes
Use this when Humanize PPT routes a deck to `beautiful-html-templates` for style exploration.
## Version boundary
Treat real Beautiful preview generation as **V0.3+**, not a V0.2 patch.
- V0.2 Router Edition: AST contracts, renderer routing, bounded commands, manifest, QA.
- V0.3 Preview-First Edition: reads `beautiful-html-templates/index.json`, selects 3 candidates, and writes real HTML preview artifacts plus manifest/report.
If a task moves a renderer from `planned` command output to real artifact generation, bump the visible capability/version rather than describing it as a minor doc update.
## Adapter workflow
1. Load or locate `beautiful-html-templates`.
- Prefer explicit `--beautiful-repo /path/to/beautiful-html-templates` when provided.
- Otherwise detect local installs/cache before attempting an auto-clone.
2. Read `index.json` and score templates using `mood`, `tone`, `occasion`, `best_for`, `density`, `scheme`, and the Humanize PPT brief.
3. Pick 3 distinct candidates; avoid three near-identical editorial choices unless the user explicitly wants that.
4. For each candidate:
- read the template `template.html`;
- extract the first cover/title slide only;
- replace placeholder title/subtitle/kicker with the real deck topic and first-slide message;
- keep/copy sibling assets and `runtime/deck-stage.js` so the preview opens standalone;
- write `outputs/beautiful/previews/NN-<slug>/index.html`.
5. Write `outputs/beautiful/previews/index.html` as the gallery.
6. Write `outputs/beautiful/preview_manifest.json` with selected templates, scores, reasons, and paths.
7. Mark the `beautiful-html-templates` route status as `rendered` in `router_plan.json`.
8. QA must treat preview render failure as a blocking issue.
## Tests to keep
A minimal regression suite should assert:
- template selection returns 3 distinct candidates;
- preview HTML contains the real title/subtitle;
- preview HTML contains exactly one slide/section;
- copied assets include `deck-stage.js` when the template depends on it;
- missing Beautiful repo returns a safe `missing-library` status instead of crashing;
- manifest/router versions match the public skill version.
## Pitfalls
- Do not only write `commands/beautiful-agent.md` and call the path connected. Preview-first means real HTML files exist.
- Do not let Beautiful consume raw noisy source directly; Humanize PPT still owns AST cleanup and production contracts first.
- Do not mix slides from multiple Beautiful templates in one preview. Each candidate preview should preserve one closed visual system.
- Do not hardcode session-specific output paths into docs; document relative output structure and show example commands.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| canvas-designanthropics/skillsCreate beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| docxanthropics/skillsUse this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| pdfanthropics/skillsUse this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| pptxanthropics/skillsUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |