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.
docs/index.md
View on GitHub# Humanize PPT
> This is the marketplace-slim package. It ships the runtime-critical
> references, adapters, and one runnable example. The full `examples/`,
> `docs/versions/`, `docs/plans/`, and `docs/showcase/` trees live in the
> upstream repo: https://github.com/LearnPrompt/humanize-ppt — links below
> that point outside this package go there.
Public preview docs. The current public preview shows the tuned Skill sharing deck plus the stable Chinese and English Hermes Agent Mastery routes.
- Showcase: https://github.com/LearnPrompt/humanize-ppt/tree/main/docs/showcase/skill-share
- Codex Guizang black-white showcase: https://github.com/LearnPrompt/humanize-ppt/tree/main/docs/showcase/codex-guizang-black-white
- Hermes Agent Mastery presenter: https://github.com/LearnPrompt/humanize-ppt/tree/main/docs/showcase/hermes-agent-mastery/presenter
- Hermes Agent Mastery PPT: https://github.com/LearnPrompt/humanize-ppt/tree/main/docs/showcase/hermes-agent-mastery/ppt
- Hermes Agent Mastery English presenter: https://github.com/LearnPrompt/humanize-ppt/tree/main/docs/showcase/hermes-agent-mastery/en/presenter
- Hermes Agent Mastery English PPT: https://github.com/LearnPrompt/humanize-ppt/tree/main/docs/showcase/hermes-agent-mastery/en/ppt
- PPT Master native Chinese Showcase: https://github.com/LearnPrompt/humanize-ppt/tree/main/docs/showcase/ppt-master-native/zh
- PPT Master native English Showcase: https://github.com/LearnPrompt/humanize-ppt/tree/main/docs/showcase/ppt-master-native/en
- Routes: Chinese HTML uses `guizang-ppt-skill`; English HTML uses `beautiful-html-templates / frontend-slides`; native editable PPTX in both languages uses `ppt-master`.
## Full annotated reference index
Moved from `SKILL.md` (which keeps only the runtime-critical shortlist).
### Core contracts & specs
- `../references/guizang-production-brief-orchestrator.md` — v0.6.4 canonical brief specification. The human + agent-facing contract for what `<renderer>-production-prompt.md` must contain and what it must not contain.
- `../SPEC.md` — engine technical specification: boundary, CLI surface (mode-check order), data flow, output contract, the v0.9 style gallery, the presentation checkup, the per-page media model, and the renderer registry. The authoritative "what the engine does and guarantees" reference.
- `../references/qa-failure-modes.md` (+ English mirror `../references/qa-failure-modes.en.md`) — failure mode catalog for the presentation checkup (演讲体检): a renderer-agnostic failure-class layer plus guizang-specific modes, each with what the audience would see. Human-readable; the code-side source of truth is `FAILURE_MODES` in `../scripts/humanize_ppt_v2.py`. Includes the WebGL-hero static-screenshot capture trap as a "static scan can't catch yet" class.
- `../references/style-gallery-spec.md` — v0.9 spec for the `--style-gallery` cover-style gate: candidates, cover-only commands, the zero-dependency picker, re-injection, and the WebGL screenshot warning.
- `../references/renderer-guidance.md` — per-renderer recommended paths (Chinese / English / native PPTX) and the known-good checkpoint rules.
- `../references/renderer-verification.md` — per-renderer verification evidence behind the SKILL.md frontmatter one-liners.
### Renderer adapters & evidence
- `../adapters/ppt-master-bridge-notes.md` — native PPTX route boundary, semantic/media/notes mapping, raw-template routing, and OOXML checkup contract.
- Real PPT Master export and Humanize PPTX checkup evidence: https://github.com/LearnPrompt/humanize-ppt/blob/main/docs/showcase/ppt-master-native/verification-2026-07-10.md
- Paired Chinese/English PPT Master exports, rendered previews, native-editability evidence, and Humanize checkup results: https://github.com/LearnPrompt/humanize-ppt/blob/main/docs/showcase/ppt-master-native/verification-2026-07-14.md
- `../references/guizang-material-qa.md` — Guizang downstream workflow, material production rules, Swiss visual QA checklist, and failure patterns learned from a full Humanize PPT → guizang deck pass. **Caveat:** these rules apply to the rendered HTML, not to the Humanize brief.
- `../references/guizang-presenter-deploy.md` — Default Chinese PPT production path: guizang stable deck, material QA, presenter shell, and static deploy checks. **Caveat:** these rules apply to the rendered HTML, not to the Humanize brief.
- `../references/beautiful-preview-first-adapter.md` — Durable adapter pattern for connecting `beautiful-html-templates`: version boundary, template selection, real title-slide previews, manifests, QA, and pitfalls. (Historical; v0.6.4 hands template selection to the downstream skill.)
- `../references/selected-template-full-deck-adapter.md` — Durable adapter pattern for V0.4 selected-template full deck generation: required artifacts, routing, QA, and TDD coverage. (Historical.)
- `../references/presenter-export-adapter.md` — Durable adapter pattern for adding V0.5-style presenter shell and export package after a final deck exists. (Historical; v0.6.4 hands presenter/export to the downstream skill.)
### Helper scripts
- `../scripts/preview_outline_html.py` — outline preview: renders the audience state-transfer map (one zero-dependency single-file HTML; per-slide enter-state → intent → leave-state rows plus a state-arc summary) from `slide_plan.json`. Real sample: https://github.com/LearnPrompt/humanize-ppt/tree/main/examples/04-preview-outline-ai-tool-update
- `scripts/record_demo_gif.py` records the style gallery + outline preview (the two zero-dependency working drafts) into one demo GIF (requires playwright + ffmpeg, plus the full upstream repo). Not included in this marketplace package; see https://github.com/LearnPrompt/humanize-ppt/blob/main/scripts/record_demo_gif.py . The gallery covers are downstream-rendered; `--covers-dir` overlays real covers before recording.
- No-dependency smoke check for validating the stable entrypoint on machines without pytest: `../scripts/smoke_check.py` (this package); full walkthrough doc at https://github.com/LearnPrompt/humanize-ppt/blob/main/docs/smoke-test.md
### Positioning & packaging
- `../references/agent-teams-public-preview.md` — Agent Teams architecture, specialist-agent command protocol, public preview release loop, and README split convention. (Historical; v0.6.4 collapses the Agent Teams model into a brief + QA loop.)
- `../references/humanize-ppt-public-writing.md` — Public-facing positioning and article/script patterns: Humanize PPT as brief orchestrator, not a fixed 4-Skill bundle.
- `../references/workbuddy-team-packaging-and-video-materials.md` — WorkBuddy/CodeBuddy team upload zip structure, validation script, scenario rules shape, and the Remotion/HyperFrames-as-material-producers pitfall.
### Version notes
Full version history lives upstream at https://github.com/LearnPrompt/humanize-ppt/tree/main/docs/versions — this package does not ship it.
- https://github.com/LearnPrompt/humanize-ppt/blob/main/docs/versions/v1.1.0-ppt-master.md — release notes for native PPTX routing, raw-template fill, and OOXML checkup.
- https://github.com/LearnPrompt/humanize-ppt/blob/main/docs/versions/v0.9.0-style-gallery.md — the cover-style gallery gate, the WebGL static-screenshot failure class, the English failure-mode mirror, SPEC.md, and the README/GIF-slot work.
- https://github.com/LearnPrompt/humanize-ppt/blob/main/docs/versions/v0.8.0-presentation-checkup.md — why the QA loop was renamed to presentation checkup, the hot-pluggable route framing, the plain-language usage rewrite, and the verified English checkup run.
- https://github.com/LearnPrompt/humanize-ppt/blob/main/docs/versions/v0.7.0-render-qa-inspector.md — why the positioning moved to render-QA inspector, English-path support levels, and the outline preview artifact.
- https://github.com/LearnPrompt/humanize-ppt/blob/main/docs/versions/v0.6.4-guizang-production-brief-orchestrator.md — what changed, lessons, boundaries, known-good checkpoint, QA loop cap.
- https://github.com/LearnPrompt/humanize-ppt/blob/main/docs/versions/v0.6.3-english-style-gallery.md — theme-first gate, five visible style candidates, and selected-style continuation.
- https://github.com/LearnPrompt/humanize-ppt/blob/main/docs/versions/v0.6.2-guizang-presenter-deploy.md — Chinese default path, `postMessage` presenter shell, and public static showcase.
- https://github.com/LearnPrompt/humanize-ppt/blob/main/docs/versions/v0.6.1-guizang-material-qa.md — downstream artifact recording, Remotion-as-material, SVG-safe Chinese diagrams, and visual review rules.
- https://github.com/LearnPrompt/humanize-ppt/blob/main/docs/versions/v0.5-presenter-export-adapter.md — `--presenter-adapter`, `--export-adapter`, output artifacts, and boundaries.
- https://github.com/LearnPrompt/humanize-ppt/blob/main/docs/versions/v0.4-selected-template-full-deck.md — `--selected-template`, selected deck output, manifests, QA, and current boundaries.
- https://github.com/LearnPrompt/humanize-ppt/tree/main/docs/versions — `v0.2-router-edition.md` through `v0.6.3-english-style-gallery.md` and beyond: historical version notes, kept for context.
- Release-readiness checklist and release-note draft: https://github.com/LearnPrompt/humanize-ppt/blob/main/docs/plans/2026-05-25-release-readiness-checklist.md
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 |