Skip to content

bestdeejay-design/agent-skills / skills/presentation-maker

presentation-maker

Verified

End-to-end presentations from a topic — outline -> JSON spec -> 16:9 HTML slides (with mandatory Playwright verification) and real .pptx (full 14-type design system), plus strategy presets, PDF export, and deck-quality audits. One command per stage.

FileKindSize
SKILL.mdskill md20.8 KB
evals/evals.jsonconfig731 B
examples/cases/lovii-pitch/case.jsonconfig581 B
examples/cases/lovii-pitch/deck.jsonconfig7.8 KB
examples/cases/lovii-pitch/slides.htmlother46.2 KB
examples/demo/demo_deck.jsonconfig7.9 KB
examples/demo_deck.jsonconfig7.9 KB
readme.ru.mdmarkdown4.5 KB
references/audit.mdmarkdown7.3 KB
references/bento.mdmarkdown20.4 KB
references/design-system.mdmarkdown7.2 KB
references/pdf.mdmarkdown2.5 KB
references/product-designer.mdmarkdown11.2 KB
references/references.mdmarkdown489 B
references/strategy.mdmarkdown7.7 KB
scripts/build_bento.pyscript61.9 KB
scripts/build_html.pyscript41.2 KB
scripts/build_pdf.pyscript5.9 KB
scripts/build_pptx.pyscript46.4 KB
scripts/cases.pyscript2.7 KB
scripts/composer.pyscript12.4 KB
scripts/content_profile.pyscript4.6 KB
scripts/creative_brief.pyscript7.4 KB
scripts/deck_audit.pyscript17.0 KB
scripts/deck_md.pyscript22.7 KB
scripts/fit_solver.pyscript7.5 KB
scripts/patterns.pyscript3.4 KB
scripts/polish.pyscript4.0 KB
scripts/qa_bento.pyscript34.7 KB
scripts/qa_intern.pyscript5.8 KB
scripts/qa_pptx.pyscript8.6 KB
scripts/strategy.pyscript9.8 KB
scripts/verify_slides.pyscript5.4 KB
scripts/vision_qa.pyscript9.0 KB
skill.jsonconfig2.1 KB
templates/base.htmlother54.7 KB
templates/icons/arrow-right.svgother128 B
templates/icons/award.svgother211 B
templates/icons/bot.svgother212 B
templates/icons/briefcase.svgother233 B
templates/icons/building.svgother171 B
templates/icons/chart.svgother197 B
templates/icons/family.svgother240 B
templates/icons/graduation.svgother163 B
templates/icons/presentation.svgother256 B
templates/icons/users.svgother240 B
templates/icons/zap.svgother188 B
templates/pattern-css/before-after.cssother285 B
templates/pattern-css/big-type.cssother390 B
templates/pattern-css/card-dashboard.cssother552 B
templates/pattern-css/cyclic-process.cssother702 B
templates/pattern-css/data-story.cssother611 B
templates/pattern-css/editorial-asym.cssother787 B
templates/pattern-css/hero-left.cssother697 B
templates/pattern-css/quote-hero.cssother533 B
templates/pattern-css/recap-grid.cssother461 B
templates/pattern-css/soft-shapes.cssother1.0 KB
templates/pattern-css/sparkline-metric.cssother534 B
templates/pattern-css/split-diagonal.cssother547 B
templates/pattern-css/split-frame.cssother841 B
templates/pattern-css/swiss-grid.cssother1.0 KB
templates/pattern-css/vertical-rail.cssother2.1 KB
templates/pattern-css/vertical-stepper.cssother882 B
templates/pattern-css/z-pattern.cssother750 B
templates/pattern-css/zigzag-timeline.cssother312 B
templates/patterns/before-after.jsonconfig1.1 KB
templates/patterns/big-type.jsonconfig1.1 KB
templates/patterns/card-dashboard.jsonconfig1.1 KB
templates/patterns/cyclic-process.jsonconfig990 B
templates/patterns/data-story.jsonconfig1.1 KB
templates/patterns/editorial-asym.jsonconfig1.2 KB
templates/patterns/hero-left.jsonconfig1.2 KB
templates/patterns/quote-hero.jsonconfig1.1 KB
templates/patterns/recap-grid.jsonconfig978 B
templates/patterns/soft-shapes.jsonconfig1.1 KB
templates/patterns/sparkline-metric.jsonconfig1017 B
templates/patterns/split-diagonal.jsonconfig1.2 KB
templates/patterns/split-frame.jsonconfig1.1 KB
templates/patterns/swiss-grid.jsonconfig1.2 KB
templates/patterns/vertical-rail.jsonconfig1.1 KB
templates/patterns/vertical-stepper.jsonconfig1.0 KB
templates/patterns/z-pattern.jsonconfig1.1 KB
templates/patterns/zigzag-timeline.jsonconfig1004 B
templates/themes/dynamic.jsonconfig520 B
templates/themes/executive.jsonconfig526 B
templates/themes/general.jsonconfig515 B
templates/themes/lovii.jsonconfig647 B
templates/themes/modern.jsonconfig546 B
templates/themes/momentum.jsonconfig508 B
templates/themes/neo-consulting.jsonconfig862 B
templates/themes/standard.jsonconfig605 B
templates/themes/swift.jsonconfig552 B

references/bento.md

View on GitHub
# Bento JSON sidecar — формат и валидация

Спецификация JSON-боковой панели (`doc.json`), встраиваемой в `.bento.html` через
`<script type="application/bento+json" id="bento-doc">`. Формат описан в
[nyblnet/bento](https://github.com/nyblnet/bento) (MIT). Этот документ — справочник
по структуре, ограничениям и кодам проверок.

---

## Файл и извлечение

`.bento.html` — самодостаточный HTML-файл. Внутри него ровно один блок
`<script type="application/bento+json" id="bento-doc">` содержит JSON-объект
документа. Валидатор (`qa_bento.py`) принимает оба формата:

* **`.bento.html`** — извлекает JSON из `#bento-doc` блока.
* **`.doc.json`** — читает JSON напрямую (если файл начинается с `{`).

Валидатор — browser-free, stdlib-only (argparse, json, re, html, pathlib).

---

## Корневой объект

| Поле | Тип | Обязательно | Описание |
|------|-----|-------------|----------|
| `format` | строка | да | Всегда `"bento/slides"` |
| `version` | число | да | Всегда `1` |
| `docId` | строка | да | Уникальный идентификатор документа |
| `title` | строка | да | Название презентации |
| `size` | объект | да | `{width, height}` — размер слайда в px |
| `theme` | объект | да | Тема (палитра, шрифты) |
| `slides` | массив | да | Массив слайдов |
| `modified` | строка | да | ISO-дата последнего изменения |
| `meta` | объект | нет | Мета: author, company, subject, event, keywords |
| `present` | объект | нет | Настройки презентации |
| `assets` | объект | нет | Документ-уровневые ассеты (ключ → тип/данные) |
| `blobs` | объект | нет | BLOB-данные |
| `fonts` | массив | нет | Встроенные шрифты (`[{family, asset}]`) |
| `layouts` | объект | нет | Переиспользуемые шаблоны слайдов |
| `collab` | объект | нет | Ключи совместного редактирования |
| `template` | строка | нет | Шаблон |
| `readonly` | булево | нет | Режим «только чтение» |

### size

```json
{"width": 1280, "height": 720}
```

`width` и `height` — положительные числа. По умолчанию 1280×720 (16:9).

### theme

| Поле | Описание |
|------|----------|
| `background` | Цвет фона слайда |
| `color` | Цвет текста по умолчанию |
| `accent` | Акцентный цвет |
| `fontFamily` | Шрифт основного текста |
| `headingFamily` | Шрифт заголовков |
| `palette` | Объект палитры (bg2, tx2, accent2–6, hlink, folHlink) |
| `chartPalette` | Палитра для графиков |
| `table` | Настройки таблиц |

### present

| Поле | Описание |
|------|----------|
| `numberHidden` | Скрыть нумерацию |
| `slideNumber` | Показать номер слайда |
| `controls` | Показать элементы управления |
| `progress` | Показать прогресс-бар |
| `morphSeconds` | Длительность morph-перехода |

---

## Слайд

| Поле | Тип | Обязательно | Описание |
|------|-----|-------------|----------|
| `id` | строка | да | Уникальный id слайда |
| `background` | строка/объект | да | Фон слайда |
| `transition` | строка | да | Переход: `none`, `fade`, `slide`, `zoom`, `morph` |
| `elements` | массив | да | Массив элементов |
| `notes` | строка | да | Заметки спикера (пустая строка — missing-notes info) |
| `name` | строка | нет | Человекочитаемое имя |
| `stateOf` | строка | нет | Id родительского слайда (state-машинка) |
| `hidden` | булево | нет | Скрытый слайд |
| `hover` | объект | нет | Hover-поведение (`{type, dim, default}`) |
| `comments` | массив | нет | Комментарии |
| `themeRefs` | объект | нет | Переопределения темы для слайда |

### transition

Допустимые значения: `none`, `fade`, `slide`, `zoom`, `morph`.

Morph — фирменный переход Bento. Деки с ≥3 слайдами без ни одного
`morph`-перехода получают warning `no-morph-anywhere`.

### state-машинка

Слайды с `stateOf` — это «состояния» другого слайда. Правила:

* `stateOf` должен указывать на существующий слайд.
* State-слайд должен стоять **сразу после** родителя (смежность).
* State/hidden-слайды без входящих ссылок — `unreachable-hidden-slide` (info).

---

## Элемент

Каждый элемент имеет **базовые поля** (общие для всех типов) и **типовые поля**
(зависят от `type`).

### Базовые поля

| Поле | Тип | Обязательно | Описание |
|------|-----|-------------|----------|
| `type` | строка | да | Тип элемента |
| `id` | строка | да | Уникальный id на слайде |
| `x` | число | да | X-координата (px) |
| `y` | число | да | Y-координата (px) |
| `w` | число | да | Ширина (px), > 0 |
| `h` | число | да | Высота (px), > 0 |
| `rotation` | число | да | Вращение (градусы) |
| `opacity` | число | да | Прозрачность 0..1 |
| `morphId` | строка | нет | Ключ для morph-связки между слайдами |
| `shadow` | объект/массив | нет | Тень (`{x, y, blur, color}`) |
| `blur` | число | нет | Размытие |
| `blend` | строка | нет | Режим смешивания |
| `backdropFilter` | строка | нет | CSS backdrop-filter |
| `fx` | объект | нет | Анимации и эффекты |
| `link` | строка | нет | Ссылка на другой слайд (id) |
| `group` | строка | нет | Имя группы |
| `groupId` | строка | нет | Id группы |
| `showOnHover` | строка | нет | Показать при наведении на элемент |
| `role` | строка | нет | Роль: `title`, `subtitle`, `body`, `kicker` |
| `themeRefs` | объект | нет | Переопределения темы для элемента |

### Типы элементов

#### text

| Поле | Описание |
|------|----------|
| `html` | HTML-содержимое (ограниченный набор тегов) |
| `fontSize` | Размер шрифта (px) |
| `fontFamily` | Семейство шрифта |
| `fontWeight` | Толщина шрифта |
| `color` | Цвет текста |
| `colorGradient` | Градиент `{angle, stops}` |
| `align` | Горизонтальное выравнивание: `left`, `center`, `right` |
| `valign` | Вертикальное выравнивание: `top`, `middle`, `bottom` |
| `lineHeight` | Межстрочный интервал |
| `letterSpacing` | Межбуквенное расстояние |
| `textStroke` | Обводка текста |
| `placeholder` | Заглушка |

**Ограничения HTML:** допустимые теги — `b`, `i`, `u`, `s`, `code`, `br`, `span`,
`p`, `div`, `ul`, `ol`, `li`, `h1`–`h6`. Атрибуты запрещены. Эмодзи — warning
(`emoji-in-text`): Bento-деки используют SVG/shape-иконки, не эмодзи.

**fontSize:** порог 15px (caption floor) — ниже warning `text-too-small`.
Chrome/decor-элементы (id начинается с `chrome-`, `decor`, `ghost`) исключены.

#### shape

| Поле | Описание |
|------|----------|
| `shape` | Тип: `rect`, `ellipse`, `triangle`, `arrow`, `line`, `path` |
| `fill` | Цвет заливки |
| `fillGradient` | Градиент заливки `{angle, stops}` |
| `stroke` | Цвет обводки |
| `strokeWidth` | Толщина обводки |
| `radius` | Радиус скругления |
| `strokeDash` | Пунктир обводки |
| `strokeStyle` | Стиль обводки: `solid`, `dashed`, `dotted` |
| `lineStart` | Начало линии: `none`, `arrow`, `dot`, `bar` |
| `lineEnd` | Конец линии: `none`, `arrow`, `dot`, `bar` |
| `d` | Path data (для shape=path) |
| `pathBox` | Bounding box для path |
| `from` | Начало коннектора `{el}` |
| `to` | Конец коннектора `{el}` |

#### image

| Поле | Описание |
|------|----------|
| `src` | Источник изображения (обязательно) |
| `fit` | Режим масштабирования: `contain`, `cover`, `fill` |
| `radius` | Радиус скругления |

#### svg

| Поле | Описание |
|------|----------|
| `asset` | Ключ в `doc.assets` |
| `markup` | Inline SVG-разметка |
| `css` | CSS для SVG |

Нужен хотя бы `asset` или `markup` (иначе `missing-asset`).

#### chart

| Поле | Описание |
|------|----------|
| `preset` | Тип: `bar`, `line`, `pie`, `scatter` |
| `option` | ECharts-подобный объект опций |
| `source` | Источник данных |

**Важно:** Bento использует `charts-lite`, а **не** полный ECharts.
Особенности:
* Bar/line/scatter: данные — **плоские числа**. `{name,value}` объекты → 0
  (`chart-nonnumeric-data`, error).
* Label работает только на pie (`chart-label-ignored`).
* Formatter — строковый шаблон (`{b}`, `{c}`, `{d}`), не функция
  (`chart-function-formatter`, error).
* Деки с bar/line/scatter должны иметь `xAxis` + `yAxis`
  (`chart-missing-axis`, warning).

#### table

| Поле | Описание |
|------|----------|
| `columns` | Массив колонок `[{w}]` |
| `rows` | Массив строк `[{cells: [{html, align, color, bg, bold}]}]` |
| `header` | Заголовочная строка |
| `style` | Стилизация `{headerBg, headerColor, zebra, borderColor, ...}` |

`columns[].w` — положительное число. Количество `cells` в строке должно
совпадать с числом колонок (`table-ragged-rows`).

#### media

| Поле | Описание |
|------|----------|
| `kind` | Тип медиа (`video`, `audio`) |
| `src` | Источник |
| `poster` | Обложка (для video) |
| `fit` | Режим масштабирования |
| `radius` | Радиус скругления |
| `autoplay` | Автозапуск |
| `loop` | Зацикливание |
| `muted` | Без звука |
| `controls` | Показать контролы |

#### code

| Поле | Описание |
|------|----------|
| `content` | Код |
| `fontSize` | Размер шрифта |
| `fontFamily` | Моноширинный шрифт |
| `align` | Выравнивание |
| `valign` | Вертикальное выравнивание |
| `lineHeight` | Межстрочный интервал |
| `color` | Цвет текста |
| `grammarAssetId` | Id ассета подсветки грамматики |
| `grammarName` | Имя грамматики |
| `themeAssetId` | Id ассета темы |
| `themeName` | Имя темы |

---

## fx — анимации и эффекты

| Поле | Описание |
|------|----------|
| `enter` | Входная анимация: `fade-up`, `fade`, `fade-down`, `slide-left`, `slide-right`, `slide-up`, `slide-down` |
| `enterDur` | Длительность входа |
| `order` | Порядок появления |
| `countUp` | Анимация счётчика |
| `ambient` | Фоновая анимация (ken-burns и т.п.) |
| `ken` | Ken-burns: `{dir, scale, duration}` — dir: `drift`, `out`, `in` |
| `loop` | Циклическая анимация |

### loop

| Поле | Описание |
|------|----------|
| `type` | Тип: `dash-march`, `motion-path` и др. |
| `distance` | Дистанция |
| `duration` | Длительность (сек) |
| `path` | SVG path для motion-path |
| `delay` | Задержка |
| `ease` | Функция сглаживания |
| `speeds` | Массив скоростей |

**dash-march:** требует `strokeStyle: "dashed"` или `"dotted"` — иначе
`dash-march-no-dash` (warning).

**motion-path:** требует `path`. Несовместим с `fx.enter` (оба борются за
CSS transform) → `entrance-on-motion-path` (warning).

### Морф-конфликты

Если элемент **приходит через morph** (его `morphId` есть на предыдущем слайде
с `transition: "morph"`):

* `fx.enter` → `overridden-enter-fx` (warning) — Bento пропускает вход.
* `fx.countUp` → `inert-countup` (info) — пропускается по дизайну.

---

## Коннекторы

Элементы типа `shape` могут быть коннекторами между другими элементами:

```json
{"from": {"el": "element-id"}, "to": {"el": "element-id"}}
```

Если `from.el` или `to.el` ссылается на элемент, которого нет на текущем
слайде → `dangling-connector` (warning).

---

## Границы и поля

| Правило | Порог | Код |
|---------|-------|-----|
| Canvas bounds | Элемент не должен выступать за пределы `size.width × size.height` | `out-of-canvas` (warning) |
| Content margin | Текст/таблица: x ≥ 96, x+w ≤ 1184, y+h ≤ 624 | `past-margin` (info) |
| Positive size | w > 0, h > 0 | `zero-size` (error) |
| Opacity | 0 ≤ opacity ≤ 1 | `bad-opacity` (warning) |

Chrome/decor-элементы (id: `chrome-*`, `decor*`, `ghost*`) **исключены** из
проверки canvas bounds.

---

## Дизайн-проверки

| Код | Уровень | Описание |
|-----|---------|----------|
| `no-morph-anywhere` | warning | ≥3 слайдов, ни одного `transition: "morph"` |
| `no-motion-moment` | warning | Ни один элемент не использует `countUp`, `ambient` или `loop` |
| `static-chrome` | info | Chrome-id не идентичны между слайдами (поп вместо morph) |
| `numbers-as-text` | info | Числовая серия отрисована как текстовые буллеты (нужен chart) |
| `font-not-embedded` | info | fontFamily не встроена и не системная |

---

## CLI: qa_bento.py

```bash
python3 qa_bento.py deck.bento.html
python3 qa_bento.py deck.bento.html.doc.json --strict
python3 qa_bento.py deck.bento.html --json report.json --codes
```

| Флаг | Описание |
|------|----------|
| `--json FILE` | Записать JSON-отчёт |
| `--strict` | FAIL при warnings тоже |
| `--max-warnings N` | FAIL при превышении N warnings |
| `--codes` | Вывести только уникальные коды finding'ов |
| `--quiet` | Только строка вердикта |

**Exit codes:** 0 = PASS (без ошибок), 1 = FAIL, 2 = ошибка ввода.

### JSON-отчёт

```json
{
  "deck": "deck.bento.html",
  "format": "bento/slides",
  "version": 1,
  "slides": 19,
  "elements": 200,
  "measured": false,
  "findings": [
    {
      "code": "out-of-canvas",
      "severity": "warning",
      "message": "element extends outside the 1280x720 canvas ...",
      "slide": 2,
      "element": "b1-card"
    }
  ],
  "counts": {"errors": 0, "warnings": 1, "infos": 0, "total": 1},
  "verdict": "PASS"
}
```

`measured` всегда `false` — проверка text-overflow требует реального DOM
(Playwright), этот гейт browser-free.

---

## Коды проверок

### Ошибки (error → exit 1)

| Код | Семейство | Описание |
|-----|-----------|----------|
| `bad-format` | document | format ≠ `"bento/slides"` |
| `bad-version` | document | version ≠ `1` |
| `missing-required` | document/slide | Отсутствует обязательное поле |
| `missing-asset` | document/element | Ассет не найден в `doc.assets` |
| `unescaped-lt` | document | Сырой `<` внутри `#bento-doc` блока |
| `zero-size` | element | w ≤ 0 или h ≤ 0 |
| `duplicate-slide-id` | slide | Дублирующийся id слайда |
| `duplicate-id` | element | Два элемента на одном слайде с одним id |
| `morph-key-collision` | element | Два элемента на одном слайде с одним morph key |
| `missing-element-field` | element | Нет обязательного базового поля |
| `broken-link` | element | Ссылка на несуществующий слайд |
| `missing-asset` | element | SVG/image без src/asset |
| `chart-nonnumeric-data` | chart | Bar/line/scatter данные не числа |
| `chart-function-formatter` | chart | Formatter — функция, а не строка |
| `bad-enum` | various | Значение не из допустимого набора (format, transition, align, ...) |

### Предупреждения (warning → exit 1 при --strict)

| Код | Семейство | Описание |
|-----|-----------|----------|
| `unknown-key` | various | Неизвестное поле (Bento игнорирует молча) |
| `out-of-canvas` | element | Элемент за пределами canvas |
| `text-too-small` | element | fontSize < 15px |
| `emoji-in-text` | element | Эмодзи в тексте |
| `disallowed-html-tag` | element | Тег вне подмножества Bento |
| `dash-march-no-dash` | element | dash-march без пунктира |
| `entrance-on-motion-path` | element | enter + motion-path конфликт |
| `overridden-enter-fx` | element | enter на morph-приходящем элементе |
| `state-not-adjacent` | slide | State-слайд не сразу после родителя |
| `missing-transition` | slide | Переход не из допустимого набора |
| `table-ragged-rows` | table | Разное число cells в строках |
| `table-bad-weight` | table | Отрицательный/нулевой вес колонки |
| `chart-empty-series` | chart | Пустой массив данных |
| `chart-label-ignored` | chart | Label на не-pie графике |
| `chart-missing-axis` | chart | Cartesian без xAxis/yAxis |
| `no-morph-anywhere` | design | Нет morph-перехода в деке |
| `no-motion-moment` | design | Ни одного动态-эффекта |
| `dangling-connector` | element | Коннектор ссылается на отсутствующий элемент |
| `bad-opacity` | element | opacity вне 0..1 |
| `bad-enum` | various | Невалидное значение перечисления |

### Информационные (info → не влияют на exit)

| Код | Семейство | Описание |
|-----|-----------|----------|
| `past-margin` | element | Контент за пределами 96px margin |
| `missing-notes` | slide | Пустые заметки спикера |
| `unreachable-hidden-slide` | slide | Hidden/state слайд без входящих ссылок |
| `font-not-embedded` | element | Шрифт не встроен и не системный |
| `collab-secrets-present` | document | writerPriv в collab (не для публикации) |
| `inert-countup` | element | countUp на morph-приходящем элементе |
| `static-chrome` | design | Chrome-id не идентичны |
| `numbers-as-text` | design | Числовая серия как буллеты |
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall