Create, review, or edit SuperDeck presentations and presentation apps. Use when working with `slides.md`, SuperDeck Markdown syntax, fullscreen slides, `@section`/`@block`/`@widget` layout, built-in widgets such as `@image`, `@dartpad`, `@webview`, and `@qrcode`, custom Flutter widgets, `DeckOptions`, `BlockVariant`, slide parts, templates, styles, images/assets, CLI builds, plugins, or validation of SuperDeck deck behavior.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
Create, review, or edit SuperDeck presentations and presentation apps. Use when working with `slides.md`, SuperDeck Markdown syntax, fullscreen slides, `@section`/`@block`/`@widget` layout, built-in widgets such as `@image`, `@dartpad`, `@webview`, and `@qrcode`, custom Flutter widgets, `DeckOptions`, `BlockVariant`, slide parts, templates, styles, images/assets, CLI builds, plugins, or validation of SuperDeck deck behavior.
SuperDeck Presentations
Overview
Use this skill to build accurate SuperDeck presentations: Markdown slide content, Flutter runtime wiring, assets, custom widgets, styling, templates, and verification.
Reference Routing
Load only the reference needed for the task:
Read references/authoring.md when creating or reviewing slides.md, block syntax, layouts, slide notes, built-in widgets, Markdown images, alerts, code, or hero markers.
Read references/runtime-customization.md when wiring a Flutter app, registering custom widgets, configuring DeckOptions, slide parts, styles, templates, assets, or plugins.
Read references/verification.md before claiming a deck/app works, when choosing commands, or when diagnosing build/render issues.
Workflow
Inspect the existing slides.md, lib/main.dart, pubspec.yaml, and any registered widgets/parts/templates before editing.
Decide whether the task is authoring-only, runtime customization, plugin/build setup, or verification/debugging; load the matching reference.
Prefer the repository's documented syntax and implementation behavior over generic presentation assumptions.
Keep slides readable in Markdown: use frontmatter for metadata, @section for vertical rows, child blocks/widgets for horizontal columns, and flex ratios for sizing.
Verify with a real SuperDeck build or targeted tests before reporting success.
Ground Truths
SuperDeck renders a 1280x720 logical slide into a 16:9 scaled viewport.
A slide contains vertical sections. Each @section starts a new vertical row; blocks inside that section are laid out horizontally.
@block renders Markdown. @widget and any unrecognized @name render a WidgetBlock.
Images have two authoring paths. Prefer standalone Markdown  when the image belongs in the Markdown content flow; use @image { src: ... } when the image needs block-level layout control such as fit, fixed size, flex, align, scrollable, or data: source support.
Markdown class markers such as {.heading} or {.title} drive Hero transitions for supported Markdown elements; the class does not need a hero- prefix. Use the same tag on matching elements across adjacent slides, and do not duplicate the same tag on one slide.
@column is intentionally unsupported; use @block.
Effective content alignment is block align → section align → centerLeft.
Use section alignment as a shared default and child alignment for exceptions.
flex is a positive integer. Section flex controls vertical height; child
block flex controls horizontal width.
Section spacing creates finite, non-negative gaps only between sibling
blocks and affects horizontal space allocation. Block margin is consumed
inside that block's allocated frame, outside its decoration/border — it
reduces only that block's own usable area, never creates a shared gutter,
and never changes flex ratios (unlike CSS margins; use section spacing for
gutters). Block padding is consumed inside the decorated container,
between the border and the content. Both accept scalar, symmetric, or
physical-edge forms. Omitted object edges normalize to zero; explicit null
edges are invalid. An absent override inherits the resolved style value for
that inset; an explicit 0 removes it. A present override
replaces only the matching inset after variants resolve while preserving
other style data (decoration, clipping, animation).
SlideStyler.blockContainer accepts BlockStyler, a constrained Mix styler
supporting only padding, , , ,
, context/ variants, and animation. It cannot
express widget modifiers, width/height/constraints, transforms, or box
alignment; use for other style slots (, code
block containers, alert containers).
Source Map
Use these files to resolve disputes or update this skill:
scrollable is valid on @block and widget blocks, not on @section.
layout: fullscreen removes resolved header/footer chrome while retaining the slide's resolved background and style. normal is the default.
Built-ins image, dartpad, webview, and qrcode are always registered and can be overridden by user widgets with the same name.
@image scale is a finite number greater than zero. It changes painting, not
layout, and clips using the effective alignment and image/content frame.
@dartpad and @webview use the same deck-scoped WebView controller cache. A cacheKey enables sequential reuse across remounts, never concurrent sharing by two live blocks.
Custom widgets must be registered in DeckOptions.widgets; use shorthand @widgetName { ... } in slides.md for registered widget names.
BlockVariant('name') is a Dart/Mix stylesheet selector for all WidgetBlocks with that exact, case-sensitive name. It affects the matching container and its widget subtree, not @block content.
Styles, templates, widgets, slide parts, and plugins are configured in Dart through DeckOptions/SuperDeckApp, not through a separate styles.yaml.
The CLI reads slides.md, writes .superdeck/superdeck.json, and ensures .superdeck/ is listed in Flutter assets unless --skip-pubspec is used.
DeckOptions(debug: true) diagnoses non-scrollable Markdown and custom
widget overflow without changing Markdown wrapping or rebuilding content;
static capture omits diagnostics.
