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/design-system.md

View on GitHub
## Дизайн-система (обязательно к соблюдению)

Шаблон `templates/slides.html` уже содержит полную дизайн-систему: токены пространства/типографики, хелпер-классы и эстетические режимы (`mood`). Палитра приходит в `:root`-переменные из темы, при этом **дизайн-токены шаблона сохраняются** (сборщик переопределяет только палитровые переменные). Соблюдай систему, а не подгоняй стили «под каждую презентацию».

### 5 принципов (критично)

1. **≤2 шрифтовых семейства, ≤3 начертания.** `--font` (основной, текст/UI) и опционально `--font-display` (заголовки/акценты). Не заводи новые семейства ради пары слайдов.
2. **≤4 акцентных цвета + 1 нейтральный фон.** Палитра = 1 primary, до 2–3 акцентов (светлый/тёмный), нейтрали (`background`, `card`, `stroke`, `text`, `muted`). Больше — шум.
3. **Одна цель на слайд, один фокус-объект.** Не смешивай метрику, таблицу и график без нужды. Взгляд зрителя должен упираться в якорь (заголовок/ключевая цифра), а не блуждать.
4. **Контраст текста WCAG ≥ 4.5:1 (текст) и ≥ 3:1 (крупный/акценты).** Светлый текст на тёмном фоне и наоборот. Проверяй глазами на финальном скриншоте.
5. **Thumbnail-тест и ритм.** Слайд должен читаться с расстояния вытянутой руки и в миниатюре: крупная иерархия, воздух, единые отступы.

### 5.2 Токены (в шаблоне, используй вместо хардкода)

- **Spacing** (4px-база): `--s-1:4px … --s-9:96px` — для отступов, gap, padding.
- **Type scale** (16:9, масштабируется по размеру слайда): `--t-display`, `--t-h1`, `--t-h2`, `--t-h3`, `--t-body`, `--t-meta`, `--t-caption`.
- **Радиусы**: `--radius`, `--radius-sm`, `--radius-lg`, `--radius-full`.
- **Тени**: `--shadow`, `--shadow-hover`, `--shadow-soft`.
- **Шрифты**: `--font`, `--font-display`, `--font-mono`.
- **Контраст**: переменные `--contrast-*` (прозрачность текста по иерархии).

### 5.3 Хелперы (в шаблоне, используй в лейаутах)

- `.eyebrow` / `.eyebrow--accent` — маленький надзаголовок-рубрикатор над `h1/h2`.
- `.kicker` — подзаголовок-лид после заголовка.
- `.mono` — моноширинный текст (числа, коды, метаданные).
- `.hairline` — волосяная линия-разделитель.
- `.duotone` — двухцветный градиентный заголовок (color-mix primary+bg).
- `.index-num` — крупный номер индекса/счётчик секции.

### 5.4 Эстетические режимы (`mood`) на `.deck`

Mood можно задать в `deck.json` (`"mood": ...`) или уже вшит в темы (см. `templates/themes/*.json`). Он переопределяет радиусы/тени/шрифтовую стилистику, не трогая основной палитры.

| mood | Характер | Когда использовать |
|---|---|---|
| `swiss` | минимализм, строгая сетка, волосяные линии, display-акценты | бизнес, стратегия, аналитика, «чисто и строго» |
| `editorial` | журнальная типографика, serif-display заголовки, дуо-градиенты | бренды, контент, креатив, премиум-сторителлинг |
| `flat` | ровные карточки, крупные радиусы, без теней, бенто | стартапы, продукт, современная лаконичность |
| `glass` | полупрозрачные карточки, blur, glow — Apple-стиль | tech-продукт, keynote-стиль, премиум UI |
| `dark` | тёмный блок, моноширинная индексация, консольная строгость | тех, код, data-анализ, ночной режим |

Правило mood: не смешивай 2+ режима в одной презентации; mood должен согласовываться со смыслом (не ставь светлый мягкий mood для тёмной палитры и наоборот).

### 5.5 Перенос концепции в PPTX (`build_pptx.py`)

HTML-система переносится в `.pptx` 1:1 тем же `deck.json`: все **14 типов** слайдов
рисуются через единый набор элементов (см. SKILL.md → «PPTX design system»).
Холст 1600×900 px (`PX=7620`), контракты: `MARGIN_X=96`, `TITLE_Y=56`,
`TITLE_H=96`, `CONTENT_Y=180`, `BOTTOM_STOP=80`. Шрифт — **только Arial**
(LibreOffice не подменяет его при рендере QA).

Ключевые элементы, перенесённые из концепции:

- **eyebrow** — рубрикатор (аналог `.eyebrow`), обязателен на title/divider/closing;
- **ghost-num** — полупрозрачный номер слайда (аналог `.index-num`);
- **chrome** — лого 30×30 + индикатор `NN / NN` на каждом слайде;
- **decor-ovals** — декоративные овалы alpha 15–22% на тёмных слайдах;
- **тёмный «бутерброд»** — title/divider/closing на `primary`, контент — на `background`;
- **карточки** — rounded rect + тень (blur 10/dist 3/alpha 9%);
- **номер-кружки** — OVAL 36–44 px (process/timeline/toc);
- **маркеры-квадраты** — bullet-маркеры в стиле cards;
- **метрики 64pt / кавычка 120pt / hero-число 110pt** — масштабные акценты.

Чек-лист визуального контроля (по JPEG-рендерам `qa_pptx.py --render`):

1. На каждом слайде есть chrome (лого + `NN / NN`) и ghost-номер — ничего не съехало за холст.
2. Тёмные «бутербродные» слайды (title/divider/closing) содержат decor-овалы и eyebrow.
3. Карточки не обрезают текст: заголовки и описания целиком внутри, без пересечений.
4. Таблицы читаемы: первая колонка выделена (40%), ячейки не обрезаны, контраст AA.
5. Шрифт везде Arial — рендер LibreOffice совпадает с ожидаемым в PowerPoint.
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