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

scripts/vision_qa.py

View on GitHub
#!/usr/bin/env python3
"""vision_qa — визуальная приёмка презентации (Слой 4).

Важно: этот скрипт САМ не умеет "смотреть" на слайды — vision-модель есть
только у агента, который выполняет скил (Claude Code и т.п.), не у
изолированного Python-процесса. Поэтому vision_qa устроен в три шага:

  1. `vision_qa.py shoot slides.html` — скриншотит каждый слайд через
     .active-переключение (дожидаясь конца CSS-transition) и печатает
     ФИКСИРОВАННУЮ рубрику + список путей к картинкам. Дальше АГЕНТ обязан
     реально посмотреть на каждый файл (инструментом чтения изображений) и
     оценить по рубрике — это не опциональный шаг, а часть gate.

  2. `vision_qa.py record slides.html --slide 4 --verdict FAIL
       --check иерархия=PASS --check читаемость=FAIL
       --recommendation "..."` — агент записывает вердикт по каждому
     слайду сюда, по одному вызову на слайд, после реального просмотра.

  3. `vision_qa.py finalize slides.html` — считает итог: PASS только если
     ЗАПИСАН вердикт по каждому слайду и все они PASS. Если по какому-то
     слайду вердикта нет вообще — это FAIL с явным указанием "не
     проверено", а не тихий PASS. Раньше здесь была структурная заглушка,
     которая помечала PASS всё подряд, не глядя на скриншоты — это
     удалено, потому что не ловит вообще ничего.

Использование:
    python3 vision_qa.py shoot slides.html [--out-dir vision_shots]
    python3 vision_qa.py record slides.html --slide N --verdict PASS|FAIL
        [--check "пункт=PASS|FAIL" ...] [--recommendation "..."]
    python3 vision_qa.py finalize slides.html
"""
import argparse
import json
import sys
from pathlib import Path

RUBRIC = """Оцени слайд презентации по каждому пункту (PASS/FAIL + одна фраза почему):
1. ИЕРАРХИЯ: с первого взгляда (1 сек) понятно, что на слайде главное?
2. ЧИТАЕМОСТЬ: весь текст читается без напряжения, ничего не наложено друг
   на друга, ничего не обрезано на глаз?
3. БАЛАНС: распределение элементов не выглядит случайным — есть композиционная
   логика (не "текст в углу, дыра посередине")?
4. ВОЗДУХ: достаточно пустого пространства, слайд не перегружен?
5. НЕ-ШАБЛОННОСТЬ: если бы ты видел 20 слайдов подряд из этой же деки,
   этот выглядел бы отличимым от остальных?
6. СООТВЕТСТВИЕ БРИФУ: соответствует ли ритму/доминирующему приёму из брифа?
7. ЭМОЦИОНАЛЬНЫЙ ВЕС: если это climax/hook — ощущается ли смена темпа?
   Если bridge/quiet — не перетягивает ли внимание больше, чем должен?
Слайд получает PASS, только если ВСЕ 7 пунктов — PASS."""

REPORT_SUFFIX = ".vision_qa.json"


def _report_path(html_path: str) -> Path:
    return Path(html_path).with_suffix(REPORT_SUFFIX)


def _load_report(html_path: str) -> dict:
    p = _report_path(html_path)
    if p.exists():
        try:
            return json.loads(p.read_text(encoding="utf-8"))
        except Exception:
            pass
    return {"rubric": RUBRIC, "slides": {}}


def _save_report(html_path: str, report: dict) -> None:
    _report_path(html_path).write_text(
        json.dumps(report, ensure_ascii=False, indent=2), encoding="utf-8")


def cmd_shoot(args) -> int:
    try:
        from playwright.sync_api import sync_playwright
    except ImportError:
        print("vision_qa: playwright недоступен — скриншоты не созданы", file=sys.stderr)
        return 1
    out_dir = Path(args.out_dir)
    out_dir.mkdir(exist_ok=True, parents=True)
    shots = []
    with sync_playwright() as p:
        browser = p.chromium.launch()
        page = browser.new_page(viewport={"width": 1600, "height": 900})
        page.goto(Path(args.html).resolve().as_uri())
        page.wait_for_timeout(600)
        n = page.evaluate("document.querySelectorAll('.slide').length")
        for i in range(n):
            page.evaluate(
                "(i) => document.querySelectorAll('.slide').forEach((s, j) => "
                "s.classList.toggle('active', j === i))", i)
            page.wait_for_timeout(450)  # дождаться конца CSS-transition
            shot = out_dir / f"slide-{i + 1:02d}.jpg"
            page.screenshot(path=str(shot), type="jpeg", quality=90)
            shots.append(shot)
        browser.close()

    report = _load_report(args.html)
    report["total_slides"] = len(shots)
    report["screenshots"] = [str(s) for s in shots]
    _save_report(args.html, report)

    print(RUBRIC)
    print()
    print(f"Скриншотов: {len(shots)}. Теперь ПОСМОТРИ на каждый файл ниже и оцени "
          f"по рубрике выше, затем запиши вердикт командой "
          f"`vision_qa.py record {args.html} --slide N --verdict ...`:")
    for i, s in enumerate(shots, start=1):
        print(f"  {i}: {s}")
    return 0


def cmd_record(args) -> int:
    report = _load_report(args.html)
    checks = {}
    for c in args.check or []:
        if "=" not in c:
            print(f"vision_qa: --check должен быть вида 'пункт=PASS|FAIL', получено: {c}", file=sys.stderr)
            return 2
        k, v = c.split("=", 1)
        checks[k.strip()] = v.strip().upper()
    report.setdefault("slides", {})[str(args.slide)] = {
        "verdict": args.verdict.upper(),
        "checks": checks,
        "recommendation": args.recommendation or "",
    }
    _save_report(args.html, report)
    print(f"vision_qa: слайд {args.slide} записан как {args.verdict.upper()}")
    return 0


def cmd_finalize(args) -> int:
    report = _load_report(args.html)
    total = report.get("total_slides", 0)
    slides = report.get("slides", {})
    if not total:
        print("vision_qa: нет данных о числе слайдов — сначала запусти `shoot`", file=sys.stderr)
        return 2
    missing = [i for i in range(1, total + 1) if str(i) not in slides]
    failed = {k: v for k, v in slides.items() if v.get("verdict") != "PASS"}
    report["verdict"] = "PASS" if not missing and not failed else "FAIL"
    report["missing"] = missing
    _save_report(args.html, report)
    if missing:
        print(f"vision_qa: FAIL — не оценено вручную: слайды {missing}. "
              f"Это НЕ пропуск проверки — без реального просмотра слайд не может "
              f"считаться принятым.", file=sys.stderr)
    for k, v in failed.items():
        print(f"vision_qa: слайд {k} — FAIL: {v.get('recommendation', '(без рекомендации)')}", file=sys.stderr)
    print(f"vision_qa итог: {report['verdict']}")
    return 0 if report["verdict"] == "PASS" else 1


def main() -> int:
    ap = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
    sub = ap.add_subparsers(dest="cmd", required=True)

    sp = sub.add_parser("shoot", help="скриншотить каждый слайд + напечатать рубрику")
    sp.add_argument("html")
    sp.add_argument("--out-dir", default="vision_shots")
    sp.set_defaults(func=cmd_shoot)

    rp = sub.add_parser("record", help="записать вердикт агента по одному слайду")
    rp.add_argument("html")
    rp.add_argument("--slide", type=int, required=True)
    rp.add_argument("--verdict", required=True, choices=["PASS", "FAIL", "pass", "fail"])
    rp.add_argument("--check", action="append", help="пункт=PASS|FAIL, можно повторять")
    rp.add_argument("--recommendation", default="")
    rp.set_defaults(func=cmd_record)

    fp = sub.add_parser("finalize", help="посчитать итоговый вердикт по деке")
    fp.add_argument("html")
    fp.set_defaults(func=cmd_finalize)

    args = ap.parse_args()
    return args.func(args)


if __name__ == "__main__":
    sys.exit(main())
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