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/creative_brief.py

View on GitHub
#!/usr/bin/env python3
"""creative_brief — арт-дирекшн на уровне деки (Слой 2).

Одно художественное решение на всю деку (ритм, сигнатурный приём,
climax-подача), чтобы дека №30 не походила на №1, но была цельной.
Генерируется по правилам из контента + опционально уточняется LLM.

Использование:
    python3 creative_brief.py deck.json --profile content_profile.json
                                        [-o creative_brief.json] [--llm]
"""
import argparse
import hashlib
import json
import sys
from pathlib import Path

# Каталог ритмов и сигнатурных приёмов — выбор ограничен смыслом (goal/длина),
# но ВНУТРИ допустимого подмножества варьируется по seed конкретной деки
# (название + тема + аудитория), а не только по goal — иначе любые две деки
# одного goal получают одинаковый бриф (это и была причина "все деки одинаковые").
RHYTHMS = ("dense-punchy", "airy-editorial", "data-forward", "narrative-slow")

SIGNATURE_CATALOG = [
    {
        "move": "climax-single-number",
        "description": "каждый climax-слайд — одна огромная цифра и минимум текста",
        "render_rule": {"climax": "hero-number-only"},
    },
    {
        "move": "climax-rail-number",
        "description": "climax-слайд: цифра прижата к левому краю на всю высоту, подпись справа мелко",
        "render_rule": {"climax": "hero-number-rail"},
    },
    {
        "move": "numbered-sections",
        "description": "номера разделов крупно слева, всё остальное — чисто",
        "render_rule": {"all": "index-num-large"},
    },
    {
        "move": "climax-isolated-card",
        "description": "climax-слайд: единственная карточка по центру, весь остальной холст — пустой",
        "render_rule": {"climax": "hero-number-isolated"},
    },
]


def _seed(spec: dict) -> str:
    """Seed деки для выбора художественных решений — НЕ равен deck_seed()
    из composer.py (тот же принцип, но своя соль), намеренно завязан на
    title+topic+audience, чтобы разные темы получали разные решения даже
    при одинаковом goal и похожем числе слайдов."""
    parts = [spec.get("title", ""), spec.get("topic", ""), spec.get("audience", ""),
             spec.get("goal", "")]
    return "::".join(str(p).strip().lower() for p in parts)


def _h(seed: str, salt: str) -> int:
    return int(hashlib.sha256(f"{seed}::{salt}".encode()).hexdigest(), 16)


def _pick(seed: str, salt: str, options):
    return options[_h(seed, salt) % len(options)]


def pick_rhythm(spec: dict, profile: dict) -> str:
    goal = spec.get("goal", "")
    n = len(spec.get("slides", []))
    seed = _seed(spec)
    # смысловое ограничение (что уместно для goal/длины), выбор внутри — по seed
    if goal == "pitch":
        pool = RHYTHMS if n <= 12 else tuple(r for r in RHYTHMS if r != "dense-punchy")
    elif goal in ("report", "edu"):
        pool = ("data-forward", "narrative-slow")
    else:
        pool = ("airy-editorial", "narrative-slow", "dense-punchy")
    return _pick(seed, "rhythm", pool)


def pick_signature(spec: dict, profile: dict) -> dict:
    """Сигнатурный приём: машинно-читаемое правило рендера + описание.
    Выбор ограничен наличием climax-слайдов, но внутри допустимого набора —
    по seed деки, не всегда один и тот же приём."""
    climaxes = [k for k, v in profile.items() if v.get("emphasis") == "dominant"]
    seed = _seed(spec)
    if climaxes:
        pool = [c for c in SIGNATURE_CATALOG if "climax" in c["move"]]
        chosen = dict(_pick(seed, "signature", pool))
        chosen["applies_to"] = [int(k) for k in climaxes]
        return chosen
    chosen = dict(next(c for c in SIGNATURE_CATALOG if c["move"] == "numbered-sections"))
    chosen["applies_to"] = []
    return chosen


def climax_treatment(spec: dict, profile: dict) -> dict:
    """Инструкция per-slide для climax-слайдов. Читает реальные metrics
    из spec (profile хранит только геометрию, не сырые данные слайда)."""
    slides = spec.get("slides", [])
    out = {}
    for k, v in profile.items():
        if v.get("emphasis") != "dominant":
            continue
        idx = int(k)
        if idx < 1 or idx > len(slides):
            continue
        raw = slides[idx - 1]
        metrics = raw.get("metrics") or []
        if not metrics:
            continue
        label_len = v.get("geometry", {}).get("max_label_len", 0)
        out[str(idx)] = (f"полноэкранная ключевая метрика, заголовок скромнее, "
                         f"подпись до {label_len} символов мелким капсом")
    return out


def build_brief(spec: dict, profile: dict) -> dict:
    seed = _seed(spec)
    rhythm = pick_rhythm(spec, profile)
    signature = pick_signature(spec, profile)
    # избегаемые приёмы тоже варьируются — набор-кандидат минус то, что уже
    # выбрано сигнатурой, чтобы не противоречить самому себе
    avoid_pool = [
        "одинаковая структура на каждом bullets-слайде",
        "декоративные элементы на climax-слайдах",
        "одна и та же интенсивность акцента на соседних слайдах",
        "крупный decor на слайде с длинным заголовком",
    ]
    avoid = [avoid_pool[i] for i in sorted({_h(seed, f"avoid{n}") % len(avoid_pool) for n in range(2)})]
    return {
        "seed": seed,
        "rhythm": rhythm,
        "signature_move": signature,
        "climax_treatment": climax_treatment(spec, profile),
        "avoid": avoid or avoid_pool[:2],
    }


def main() -> int:
    ap = argparse.ArgumentParser(description=__doc__)
    ap.add_argument("spec", help="deck.json")
    ap.add_argument("--profile", default="content_profile.json")
    ap.add_argument("-o", "--out", default="creative_brief.json")
    ap.add_argument("--llm", action="store_true", help="уточнить бриф через LLM")
    args = ap.parse_args()
    spec = json.loads(Path(args.spec).read_text(encoding="utf-8"))
    profile = {}
    if Path(args.profile).exists():
        profile = json.loads(Path(args.profile).read_text(encoding="utf-8"))
    brief = build_brief(spec, profile)
    Path(args.out).write_text(json.dumps(brief, ensure_ascii=False, indent=2), encoding="utf-8")
    print(json.dumps(brief, ensure_ascii=False, indent=2))
    return 0


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