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/audit.md

View on GitHub
# deck_audit — aesthetic-quality gate

Механический эстетический гейт для спецификации деки (`deck.json`), дополняющий
*функциональную* проверку переполнения `deck-html/scripts/verify_slides.py`
(Chromium layout QA). `deck_audit.py` отвечает на вопрос «выглядит ли дека
цельно / не хуже ли она стала» детерминированно (exit 0/1), без браузера.

> **Borrowed from frontend-perfection.** WCAG-математика относительной яркости
> (`relative_luminance` / `contrast_ratio`) и идея сканирования токен-блока
> (`:root{...}`) реплицированы инлайн из `skills/frontend-perfection/scripts/meta_audit.py`.
> Runtime-зависимости на `frontend-perfection` нет — математика скопирована с
> комментарием-атрибуцией.

## Использование

```bash
python3 deck_audit.py deck.json [--html slides.html] [--out report.json]
```

- `deck.json` — обязателен. Читаются `theme.palette{...}`, `theme.mood`,
  `theme.graphs`, `slides[].type/title/bullets/body`, `strategy.density`.
- `--html slides.html` — опционально. Включает проверку `tokens:raw-hex` по
  реальному HTML (поиск «голого» hex вне `:root`). Без `--html` проверяется, что
  значения палитры в `deck.json` — валидный 6-значный hex.
- `--out report.json` — записать отчёт в файл (дублирует stdout).

## Контракт выхода

- **Exit 0** — нет ни одного `fail` (предупреждения `warn` разрешены).
- **Exit 1** — хотя бы один `fail`.
- **Exit 2** — ошибка использования / IO (файл не найден, битый JSON).

Отчёт — компактный JSON (как у `meta_audit.py`): массив `checks` с полями
`id`, `title`, `status` (`pass`/`warn`/`fail`), `detail`, и блок `summary`
в конце (`total` / `passed` / `warned` / `failed`). Детерминирован: один и тот
же вход → идентичный отчёт (порядок чеков фиксирован, без рандома).

## Чек-лист аудита

### `contrast:wcag` — WCAG-контраст палитровых пар
Считает отношение контраста через WCAG 2.x relative luminance для пар:

| Пара | Порог (AA) | Примечание |
|---|---|---|
| `primary_text` на `background` | ≥ 4.5:1 | обычный текст |
| `primary_text` на `card` | ≥ 4.5:1 | обычный текст |
| `background_text` (on_primary) на `primary` | ≥ 4.5:1 | текст на акценте |
| `muted` на `background` | ≥ 4.5:1 | вторичный текст |
| `graph_0..4` на `background` | ≥ 3:1 | не-текст (линии/сегменты графика) |

- **fail**, если любая пара ниже своего порога.
- **pass**, если все пары в норме.
- Stretch (AAA): 7:1 / 4.5:1 — указывается в `detail`, но не влияет на статус.
- Значения по умолчанию (при отсутствии ключа) совпадают с `build_html.py`.

**Фикс:** затемнить/осветлить текст или фон до нужного отношения; для графиков
брать цвета контрастнее фона. Не округлять в меньшую сторону (4.49 == fail).

### `tokens:raw-hex` — нет «голого» hex вне токен-блока
- С `--html`: любой `#hex` вне блока `:root{...}` (и не из `SHADOW_GREYS`
  `#000`/`#fff`) — **fail**. Все цвета должны жить в токенах (правило
  дизайн-системы: «zero raw hex outside the token block»).
- Без `--html`: каждое значение палитры должно быть валидным 6-значным hex —
  иначе **fail**.

**Фикс:** вынести цвет в CSS-переменную в `:root`; в `deck.json` писать только
через `theme.palette`.

### `palette:roles` — бюджет акцентов (≤4)
Акцентные роли = `primary` + `graph_0..4`. Считаются **различные** (без учёта
регистра) цвета.
- **warn**, если > 4 различных акцентов (шум в палитре).
- **pass**, если ≤ 4.

**Фикс:** сократить число графиковых/акцентных цветов; держать 60-30-10.

### `headline:assertion` — заголовки-выводы (advisory)
Для каждого слайда, чей `type` не в `{title, divider, closing, cover, section}`,
заголовок должен быть **assertion headline** — полное предложение с глаголом
(вывод, а не тема). Эвристика (RU/EN): помечает заголовок, если ≤2 слов ИЛИ не
найден глагол (лексикон EN + суффиксные правила RU).
- **warn**, если есть тема-стиль заголовки. Не блокирует сборку.
- **pass**, если все проверенные заголовки — выводы.

**Фикс:** переписать «Выручка» → «Рост выручки ускорился до 40% в Q3».

### `density:words` — бюджет слов на слайд
Оценивает слова на слайд из `title` + `body` + `bullets`.
- Лимит: 60 (standard) / 120 (`strategy.density == "text-heavy"`).
- **warn**, если превышен. Не блокирует.
- **pass**, если в бюджете.

**Фикс:** разбить плотный слайд; перенести детали в приложение; правило 50/25/10.

### `consistency:mood` — единый mood на деку
Дека должна использовать один `theme.mood` (слайды могут переопределять, но
тогда должен совпадать).
- **fail**, если встречено >1 различных mood (включая переопределения в слайдах).
- **pass**, если mood один (или не задан).

**Фикс:** выбрать один mood, согласованный со смыслом и палитрой.

## Соответствие дизайн-системе

Правила взяты из `deck-html/references/design-system.md` и `product-designer.md`:
≤2 шрифта, ≤4 акцента, одна идея/слайд, WCAG ≥4.5:1 (текст) / ≥3:1 (крупный и
не-текст), assertion-заголовки, контент <60% площади, один radius/stroke на деку,
без эмодзи-иконок. `deck_audit` механически покрывает контраст, токены, бюджет
акцентов, заголовки-выводы, плотность и единство mood; остальное (плотность
визуальная, иконография) — за рамками статического чека.
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