siril9/presentation-skill / plugins/presentation-skill/skills/presentation-skill
presentation-skill
FlaggedBuild, edit, redesign, render, and verify content-led, structurally diverse, clean, editable, reproducible PowerPoint `.pptx` decks. Use for scientific, lab, clinical, consulting, board, investor, editorial, policy, and operational presentations where alignment, readability, contrast, and balanced density matter.
references/reproducible_workflow.md
View on GitHub# Reproducible Workflow (Workspace Standard)
Use this file as the default execution contract for future deck work in this workspace.
## Objective
Generate decks with consistent visual quality and repeatable structure, not one-off styling.
## Environment Policy
- Install dependencies once per environment, not per run.
- Core deck generation only needs the Python builder stack.
- LibreOffice `soffice` and Poppler `pdftoppm` are optional unless you are running render-based QA or the full benchmark harness.
- Optional HTML rendering dependencies should only be installed when that path is explicitly needed.
## Default Inputs
- Minimum required user inputs:
- Audience
- Decision objective
- Slide count target
- Required sections
## Layout System
Use only these proven layout families unless user asks otherwise:
1. Hero opener (dark background, large title, short subtitle, motif icon/circles)
2. Card grid (2-3 columns with icon + heading + concise body)
3. Split panel (content left, metric/checklist/commands right)
4. Comparison layout (two mirrored rounded cards)
5. Table comparison (head-to-head features)
6. Closing slide (key takeaways with short bullets)
Do not repeat one layout family for consecutive slides unless required.
## Typography Rules
- Keep strong hierarchy:
- Title: 36-48 pt
- Section heading: 22-30 pt
- Body: 14-20 pt
- Caption/footer: 11-14 pt
- Use at most 2-3 font families in one deck.
- Keep body copy left-aligned.
- Keep line lengths reasonable; split dense text into cards.
## Color Rules
- Use one dominant background tone, one secondary support tone, one accent.
- Maintain contrast (especially on dark slides).
- Use accent color consistently for icons, rails, or callouts.
## Content Density Rules
- One core message per slide.
- 3-6 bullets max per content block.
- Prefer short lines over paragraph walls.
- Convert long lists into grids/cards where possible.
## Preflight (Static Outline Lint)
Before running the slow build + render cycle, run the static preflight
linter against `outline.json`. It catches common authoring errors in
under a second:
```bash
python3 scripts/preflight.py --outline outline.json
```
Exit codes:
- `0` - clean.
- `1` - warnings only (non-blocking).
- `2` - blocking errors (e.g., malformed chart, missing cards array,
invalid `font_pair`).
- `3` - outline JSON is malformed.
`scripts/build_workspace.py` runs preflight first automatically. Use
`--strict-preflight` to abort the build on any preflight error, and
`--skip-preflight` to disable the check entirely. When `--qa` is set the
build already behaves strictly (blocking errors abort), because those
errors will reliably fail the downstream QA gate anyway and there's no
point paying the ~60s render cost to confirm it.
Use `--strict-preflight` when:
- You're iterating quickly and want fast failure feedback.
- You're running in CI and want build failures before render.
- You want to block authoring errors (non-numeric stats, malformed
chart, bad font_pair) from ever reaching the renderer.
Skip preflight (`--skip-preflight`) only when you're intentionally
bypassing lint for a known-divergent outline, e.g., debugging a
renderer-side bug against a crafted edge-case input.
## Mandatory QA Loop
### 1) Content QA
```bash
python3 scripts/extract_outline.py --input output.pptx --format markdown
python3 -m markitdown output.pptx
```
Verify no placeholder remnants, missing sections, or ordering issues.
### 2) Visual QA
```bash
python3 scripts/render_slides.py --input output.pptx --outdir /tmp/slide-review
python3 scripts/visual_review.py \
--input output.pptx \
--outdir /tmp/slide-review-packet \
--renders-dir /tmp/slide-review \
--outline outline.json
```
Verify:
- No clipping/overflow
- No overlaps
- Consistent margins
- Aligned cards/columns
- Adequate contrast
- No orphaned last-line words, awkward KPI units, or repeated layout rhythm
### 3) Fix-and-Reverify
- Run deterministic loop (max 3):
```bash
python3 scripts/iterate_deck.py \
--input output.pptx \
--output output.pptx \
--style-preset executive-clinical \
--max-loops 3 \
--outdir /tmp/pptx-iterations
```
By default, intermediate iteration loops no longer render. Only the final
loop runs the full soffice render pass, which cuts total iteration time
roughly 60-80% for a 3-loop run. Pass `--always-render` to restore the old
behavior (render on every loop) when you genuinely need the render diff
between intermediate fixes. `--fast` is a render-free shortcut
(`--max-loops 3 --skip-render`) for quick drafts. See
`speed_and_rendering.md` for details and the `unoserver` daemon speedup.
- Run strict final gate:
```bash
python3 scripts/qa_gate.py \
--input output.pptx \
--outdir /tmp/pptx-qa-final \
--style-preset executive-clinical \
--strict-geometry \
--run-visual-review \
--report /tmp/pptx-qa-final/qa_report.json
```
- Add manual review artifact when visual pass is complete:
```bash
touch /tmp/pptx-qa-final/manual_review_passed.flag
```
## Delivery Standard
Before final delivery, provide:
- Final `.pptx`
- Brief slide-by-slide change summary
- Notes on assumptions/substitutions (fonts, icons, imagery)
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 |