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/design_philosophy.md
View on GitHub# Design Philosophy — reference tables
> **The canonical design standard lives in `DESIGN.md`.**
> This file only lists the loadable preset + font_pair values the builder
> accepts. Read DESIGN.md first.
## Loadable presets (`--style-preset` values)
These are the 13 values `build_deck.py` / `build_workspace.py` /
`build_deck_pptxgenjs.js` accept. DESIGN.md explains
when to pick each one.
| Preset | Mood |
|---|---|
| `executive-clinical` | Cool navy + teal/amber — default for strategy and enterprise |
| `bold-startup-narrative` | Saturated, confident — pitch decks |
| `data-heavy-boardroom` | Restrained, high-contrast data — metrics, board memos |
| `sunset-investor` | Warm oranges + navy — fundraising, vision arcs |
| `forest-research` | Green + cream — climate, biology, sustainability |
| `midnight-neon` | Dark bg, cyan + rose accents — product launches, tech reveals |
| `paper-journal` | Warm paper + serif-ready — editorial, qualitative research |
| `arctic-minimal` | Cool gray + single accent — design systems, minimal briefs |
| `charcoal-safety` | Dark + safety red — incident reports, risk reviews |
| `lavender-ops` | Muted purple — ops dashboards, internal tooling |
| `warm-terracotta` | Earthy reds + sand — social impact, hospitality, heritage |
| `lab-report` | Restrained white/navy report — lab meetings, assay readouts, scientific figures |
| `editorial-minimal` | Spare editorial system — minimal reports and qualitative narratives |
Run `python3 -c "from scripts.design_tokens import available_presets; print(available_presets())"`
to confirm the current set if this list drifts.
## Loadable font_pair values
Pass one of these to `deck_style.font_pair`:
| `font_pair` | Title | Body | Caption |
|---|---|---|---|
| `system_clean_v1` (default) | Trebuchet MS | Calibri | Calibri |
| `editorial_serif_v1` | Georgia | Calibri | Calibri |
| `clean_modern_v1` | Trebuchet MS | Calibri | Calibri |
These are the only validated values; others silently fall back to the
default (see `_normalize_deck_style` in `build_deck.py`). If you need a
new pairing, add it to `FONT_PAIRS` in `design_tokens.py` and whitelist
its name in `_normalize_deck_style`. Do not hand-roll font names in the
outline.
## Adding a new preset or font_pair
If a deck needs a mood none of the current presets match, **add a preset
to `design_tokens.py`** rather than hand-rolling colors inline. Only
presets are validated by the builder, the renderer, and `qa_gate.py`.
Inline custom colors fall silently back to defaults in several places.
## Design DNA Patterns
Pick one design DNA before writing `outline.json`; do not use the whole
variant menu as a substitute for taste.
| DNA | Presets | Primary variants | Motifs and guardrails |
|---|---|---|---|
| Lab results dashboard | `lab-report`, `data-heavy-boardroom` | `scientific-figure`, `lab-run-results`, `image-sidebar`, `table`, `comparison-2col` | Evidence dominates. Use captions, semantic table fills, and interpretation strips. Do not use icons as evidence substitutes. |
| Board risk memo | `charcoal-safety`, `data-heavy-boardroom` | `stats`, `matrix`, `image-sidebar`, `timeline`, `table` | Dark command-center opener, sparse risk language, explicit asks. Icons can support scanability. |
| Product/investor reveal | `bold-startup-narrative`, `midnight-neon`, `sunset-investor` | optional `kpi-hero`, `cards-3` with `promote_card`, `image-sidebar`, `timeline`, `comparison-2col` | Use one cinematic KPI or hero moment only when the content earns it, then proof. Avoid generic SaaS card walls. |
| Editorial report | `paper-journal`, `editorial-minimal` | `section`, `image-sidebar`, `timeline`, `cards-2`, `generated-image` | Masthead, artifact imagery, warm paper, compact prose. Keep generated imagery standalone and labeled. |
| Civic science policy | `arctic-minimal`, `warm-terracotta`, `forest-research` | `stats`, `scientific-figure`, `matrix`, `table`, `comparison-2col` | Map/data first, plain-language policy tradeoffs, accessible contrast, visible source lines. |
Preset treatments now include cover and structure variation, not just palette:
lab decks default to `title_layout: lab-plate`, board decks to
`command-center` plus `stats_mode: feature-left`, product decks to `poster`
plus `timeline_mode: chapter-spread` when a launch milestone deserves visual
priority, editorial decks to `masthead` plus `timeline_mode: open-events` or
`bands`, and civic decks to `light-atlas` plus `matrix_mode: open-quadrants` /
`stats_mode: policy-bands`.
For richer preset differentiation, read `references/style_reference_catalog.md`
and `scripts/style_reference_catalog.py`. The catalog gives each preset a
publish-safe synthetic style family with content-treatment rules for title,
comparison, chart, table, figure, dashboard, decision, and references slides.
It also exposes `style_reference_mix_plan_v1` and
`style_reference_layout_playbook_v1`: use the mix plan to choose one primary
reference plus bounded secondary influences, then use the layout playbook to
map treatments to supported outline variants and preset-specific opening
sequences. Use those references as design memory, then render only through
supported outline variants and treatment pools. When visual examples are
needed, run `scripts/build_style_reference_gallery.py` to generate actual
synthetic reference decks and optional contact sheets without bundling external
template assets; its summary records variant sequences, chart/table treatment
sequences, treatment buckets, and QA evidence for comparing preset breadth.
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 |