bestdeejay-design/agent-skills / skills/presentation-maker
presentation-maker
VerifiedEnd-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.
readme.ru.md
View on GitHub# presentation-maker (RU)
> Русское описание скилла. Сам скилл (`SKILL.md`, `skill.json`) — на английском.
**Презентации «под ключ» из темы.** Единый конвейер из маленьких скриптов — по
одной команде на этап:
```
тема / outline.md
│ strategy.py (дуга + mood + плотность + лейауты)
▼
deck.md ──(deck_md.py)──▶ deck.json
│ ├──(build_html.py)──▶ slides.html
│ │ └──(verify_slides.py)──▶ PASS/FAIL [обязательный гейт Playwright]
│ ├──(build_pptx.py)──▶ deck.pptx
│ ├──(build_pdf.py)──▶ deck.pdf
│ └──(deck_audit.py)──▶ отчёт о качестве (JSON)
```
## Команды
```bash
# 1. Стратегия (опционально)
python3 skills/presentation-maker/scripts/strategy.py --goal keynote
python3 skills/presentation-maker/scripts/strategy.py --list
python3 skills/presentation-maker/scripts/strategy.py --show pitch
# 2. Аутлайн → спецификация
python3 skills/presentation-maker/scripts/deck_md.py outline.md -o deck.json
python3 skills/presentation-maker/scripts/deck_md.py outline.md -o deck.json \
--goal keynote --audience "инвесторы" --lang ru --palette swift --tone confident
# 3. HTML-слайды 16:9
python3 skills/presentation-maker/scripts/build_html.py deck.json slides.html
# 4. Верификация (ОБЯЗАТЕЛЬНО, Playwright)
python3 skills/presentation-maker/scripts/verify_slides.py slides.html --spec deck.json
# 5. PowerPoint
python3 skills/presentation-maker/scripts/build_pptx.py deck.json deck.pptx
# 6. PDF (из slides.html, Playwright)
python3 skills/presentation-maker/scripts/build_pdf.py slides.html deck.pdf
# 7. Аудит качества
python3 skills/presentation-maker/scripts/deck_audit.py deck.json --html slides.html
```
## Что внутри
- `scripts/` — `deck_md.py` (md→json), `strategy.py` (пресеты), `build_html.py`
(HTML 16:9), `verify_slides.py` (гейт Playwright), `build_pptx.py` (реальный
`.pptx`), `build_pdf.py` (PDF из HTML), `deck_audit.py` (эстетический гейт).
- `templates/` — `slides.html`, `themes/*.json` (general/modern/executive/momentum/
swift/standard/dynamic), `icons/*.svg`.
- `references/` — `strategy.md`, `design-system.md`, `product-designer.md`, `pdf.md`,
`audit.md`.
## Зависимости
- `python3` (stdlib для `deck_md.py`, `strategy.py`, `deck_audit.py`).
- `pip install python-pptx` — для `build_pptx.py`.
- `pip install playwright && playwright install chromium` — для `verify_slides.py`
и `build_pdf.py`.
## Генеративный слой (паттерны, v3.4+)
Каждая дека собирается из **библиотеки композиционных паттернов**
(`templates/patterns/*.json`, 15 схем), а не из одного шаблона. Селектор
(`scripts/patterns.py`) в момент сборки назначает каждому слайду свой паттерн:
контент → разнообразие (не повторять соседние 3) → `style.family` → плотность.
Один и тот же контент на разных деках отрисовывается по-разному.
Стилевое направление задаётся во frontmatter outline.md:
```yaml
style:
family: fintech # editorial | swiss | fintech | minimal | glass
reference: https://… # опционально: case / галерея
```
**Два акцента** (например teal + розовый) — по ролям, без смешения: `primary`
= структура, `accent` = акцентные точки (первое слово заголовка, линия под
заголовком, иконки метрик). На акцентном фоне текст всегда `on-primary`.
**Память скилла**: `build_html.py ... --save-case my-deck` сохраняет
`examples/cases/my-deck/` — каждая удачная дека становится референсом для
следующих.
```bash
# список сохранённых case
python3 skills/presentation-maker/scripts/cases.py
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| 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: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |