Skip to content

JunfengRan/PPTWork / ppt

Build PPT / PowerPoint / 演示文稿 / slide decks end-to-end via a .pptwork/<deck>/ filesystem contract. Use when the user wants to plan, author, screenshot, or export a slide deck. Provides Node scripts for deck CRUD, headless screenshot, and editable PPTX export. Covers clarification, story planning, single-page authoring (via the ppt-html-authoring skill), visual QC, and export troubleshooting.

FileKindSize
SKILL.mdskill md13.2 KB
assets/claude-warm/_preview/bento-asymmetric/slide.htmlother3.6 KB
assets/claude-warm/_preview/bento-asymmetric/thumbnail.pngbinary65.2 KB
assets/claude-warm/_preview/cover-editorial/slide.htmlother2.0 KB
assets/claude-warm/_preview/cover-editorial/thumbnail.pngbinary43.0 KB
assets/claude-warm/_preview/flow-timeline/slide.htmlother3.1 KB
assets/claude-warm/_preview/flow-timeline/thumbnail.pngbinary30.3 KB
assets/claude-warm/_preview/quote-highlight/slide.htmlother1.7 KB
assets/claude-warm/_preview/quote-highlight/thumbnail.pngbinary33.6 KB
assets/claude-warm/_preview/section-divider/slide.htmlother1.8 KB
assets/claude-warm/_preview/section-divider/thumbnail.pngbinary35.6 KB
assets/claude-warm/html/bento-asymmetric.htmlother3.6 KB
assets/claude-warm/html/cover-editorial.htmlother2.0 KB
assets/claude-warm/html/flow-timeline.htmlother3.1 KB
assets/claude-warm/html/quote-highlight.htmlother1.7 KB
assets/claude-warm/html/section-divider.htmlother1.8 KB
assets/claude-warm/index.jsonconfig1.8 KB
assets/corporate-light/_preview/agenda-grid/slide.htmlother3.2 KB
assets/corporate-light/_preview/agenda-grid/thumbnail.pngbinary53.5 KB
assets/corporate-light/_preview/closing-cta/slide.htmlother2.2 KB
assets/corporate-light/_preview/closing-cta/thumbnail.pngbinary91.8 KB
assets/corporate-light/_preview/cover-hero/slide.htmlother2.4 KB
assets/corporate-light/_preview/cover-hero/thumbnail.pngbinary198.9 KB
assets/corporate-light/_preview/kpi-stat-row/slide.htmlother2.4 KB
assets/corporate-light/_preview/kpi-stat-row/thumbnail.pngbinary127.6 KB
assets/corporate-light/_preview/two-column-insight/slide.htmlother3.6 KB
assets/corporate-light/_preview/two-column-insight/thumbnail.pngbinary42.5 KB
assets/corporate-light/html/agenda-grid.htmlother3.2 KB
assets/corporate-light/html/closing-cta.htmlother2.2 KB
assets/corporate-light/html/cover-hero.htmlother2.4 KB
assets/corporate-light/html/kpi-stat-row.htmlother2.4 KB
assets/corporate-light/html/two-column-insight.htmlother3.6 KB
assets/corporate-light/index.jsonconfig2.0 KB
package.jsonmanifest484 B
references/disk-layout.mdmarkdown2.2 KB
references/editable-html-rules.mdmarkdown2.0 KB
references/export-troubleshooting.mdmarkdown5.8 KB
references/material-digest.mdmarkdown2.0 KB
references/research.mdmarkdown2.7 KB
references/story-planning.mdmarkdown5.2 KB
references/visual-qc.mdmarkdown4.4 KB
scripts/deck.mjsscript9.5 KB
scripts/export.mjsscript8.0 KB
scripts/import-reference.mjsscript1.2 KB
scripts/lib/deck.mjsscript2.1 KB
scripts/lib/find-browser.mjsscript1.7 KB
scripts/lib/render.mjsscript12.6 KB
scripts/screenshot.mjsscript2.5 KB
test/smoke.mjsscript10.1 KB

references/visual-qc.md

View on GitHub
# Phase: visual QC

After authoring a slide, screenshot it and verify against the visual checklist
before declaring the page done.

## Inputs

- Deck name + slide name
- Optional iteration cap (default 3)
- Optional user-supplied complaint ("title overlapping the image", "footer
  cropped")

## Workflow

1. **Screenshot:** `node skills/ppt/scripts/screenshot.mjs <deck> <slide>` →
   refreshes / creates `thumbnail.png` in the slide folder.
2. **Read the thumbnail.** Open it as an image. If your environment cannot
   render images, you cannot self-verify — return that fact instead of
   inventing visual judgments.
3. **Walk the checklist below**, prioritized A → D.
4. **Pass → done.** **Fail → micro-edit `slide.html`** in place:
   - Allowed: font-size, padding, gap, line-height, color, object-fit,
     replacing the contents of a `data-id` node.
   - Forbidden: changing the narrative, restructuring the layout,
     adding/removing `data-id` nodes, rewriting the title logic — those
     belong to the authoring phase.
5. **Re-screenshot.** Repeat until pass or iteration cap.
6. **Cap reached without pass:** return a structured failure (which item
   failed, current value, expected value, suggested next step). Do not
   silently force a pass.

## Visual checklist

### A. Hard errors (must fix)

- [ ] No unintended bbox overlap.
- [ ] No text overflow past version safe area / card container.
- [ ] No critical text / numbers occluded by decoration.
- [ ] At least ~48px bottom safe margin on important text.
- [ ] Screenshot shows real content (not blank, not skeleton-only, not
  scripts-failed-to-run).

### B. Information density

**B1. Anti-"filler page" (mandatory for content pages; covers / agendas /
section breaks / closings exempt)**

- [ ] At least one visual element per page (chart / diagram / data card /
  image).
- [ ] 3~7 core bullets. Less than 3 is too sparse, more than 7 should split.
- [ ] Each bullet ≤ 60 chars; longer should split or convert to a chart.
- [ ] No paragraphs over 80 chars; break into bullets or extract a chart.
- [ ] Key numbers cite a source (footer or card footnote).

**B2. Visual elements actually rendered**

- [ ] Data pages have charts (not "numbers + a paragraph").
- [ ] Image slots (`[data-role="image-slot"]`) show real visuals, not just
  placeholder copy like "scene illustration".
- [ ] Diagram connector lines actually link to targets (not floating, not
  off-by-N).
- [ ] Chart.js canvas has bars/lines/pies (animation off + parent has height).

**B3. No "filler page" smell**

- [ ] Painted area covers >= 70% of the version safe area (≤30% white space
  is healthy).

### C. Typography & layout

- [ ] Alignment: cards / text boxes share top / left / centerline within
  visual tolerance.
- [ ] Type scale: body >= 10pt (12pt recommended), titles 20pt+, same level
  same size.
- [ ] Whitespace rhythm consistent between cards / text blocks.
- [ ] Restraint on emphasis: highlight color / bold / large size used at most
  2~3 times per page.

### D. Story transition + speaker notes

- [ ] design.md `Design` section names the transition rationale; the
  thumbnail's overall feel sits with neighboring pages.
- [ ] design.md `Note` section is mirrored into a
  `#ppt-speaker-notes-json` node inside slide.html — otherwise the exported
  PPTX has empty speaker notes.

## Priority

When multiple issues fire:

1. **A** (overlap / overflow / occlusion / blank) — must fix
2. **B** (data page without chart, image-slot empty) — must fix
3. **C** (alignment, type, whitespace) — fix
4. **D** (transition feel) — review at deck-finalization time

## Decision rules

- Hard issues (overlap / overflow) outrank soft issues (alignment / spacing).
- Minor rule warnings (e.g. body text 13.4pt vs recommended 14pt) may stay
  if the eye doesn't catch it; the rules aren't a strict gate.
- Don't sacrifice narrative or visual focus just to satisfy the checklist.
- An empty image-slot is **not** a visual issue — it's the authoring phase
  not finishing. Hand it back to authoring; do not edit slide.html in QC.

## Pre-export sanity

- A clean screenshot does not guarantee a clean exported PPTX.
- If the user later complains "exported PPTX layout is broken / fonts wrong /
  doesn't match preview", switch to raster export (`scripts/export.mjs <deck>`
  already runs raster mode in this skill build).
- Pages with `[data-role="image-slot"]` should be screenshotted again right
  before export to confirm the slot has real content.
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: 197kUpdated Claude CodeCodexVerifiedInstall
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: 197kUpdated Claude CodeCodexVerifiedInstall
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: 197kUpdated Claude CodeCodexVerifiedInstall
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: 197kUpdated Claude CodeCodexVerifiedInstall