Skip to content

2654400439/Paper2Seminar / skills/paper-ppt-orchestrator

paper-ppt-orchestrator

Verified

Build complete fixed-layout academic-paper presentations from a PDF with bundled PPTX and one-page HTML templates. Use for full paper reading, complexity-aware slide budgeting, subsection coverage mapping, figure extraction, TikZ or Matplotlib evidence visuals, deterministic PPTX assembly, and final QA. Trigger for requests to turn a paper PDF into a discussion-group deck, especially 12-16+ page systems, security, networking, or measurement papers.

FileKindSize
SKILL.mdskill md17.9 KB
agents/openai.yamlconfig296 B
assets/one-page-summary.htmlother7.8 KB
assets/seminar-template.pptxbinary572.7 KB
references/content-design.mdmarkdown5.7 KB
references/data-viz.schema.jsonconfig2.9 KB
references/deck-plan.schema.jsonconfig8.5 KB
references/deck-sizing.mdmarkdown3.4 KB
references/environment-compatibility.mdmarkdown2.8 KB
references/feature-registry.jsonconfig1.4 KB
references/figure-extraction.mdmarkdown5.1 KB
references/job-request.defaults.jsonconfig1.6 KB
references/job-request.schema.jsonconfig7.5 KB
references/one-page-template.mdmarkdown3.1 KB
references/qa-gates.mdmarkdown10.0 KB
references/speaker-notes.mdmarkdown3.1 KB
references/template-contract.mdmarkdown5.1 KB
references/tikz-layout.mdmarkdown12.2 KB
references/visual-selection.mdmarkdown6.5 KB
references/workflow.mdmarkdown9.8 KB
requirements-doclayout.txtmarkdown238 B
requirements-ui.txtmarkdown39 B
requirements.txtmanifest68 B
scripts/apply_speaker_notes.pyscript6.1 KB
scripts/build_ppt.pyscript16.3 KB
scripts/crop_author_block.pyscript7.9 KB
scripts/crop_image_region.pyscript2.4 KB
scripts/export_pptx_pages.ps1script1.3 KB
scripts/extract_paper_assets.pyscript22.3 KB
scripts/job_request.pyscript17.1 KB
scripts/make_contact_sheet.pyscript4.0 KB
scripts/paper_ppt.pyscript17.1 KB
scripts/preflight_capabilities.pyscript8.3 KB
scripts/render_data_viz.pyscript14.6 KB
scripts/render_deck_overview.pyscript2.4 KB
scripts/render_one_page_html.pyscript13.4 KB
scripts/render_readability.pyscript4.1 KB
scripts/update_qa_status.pyscript10.1 KB
scripts/validate_deck_plan.pyscript33.9 KB
webapp/__init__.pyscript49 B
webapp/backend.pyscript14.5 KB
webapp/job_runner.pyscript3.2 KB
webapp/streamlit_app.pyscript17.3 KB

scripts/render_readability.py

View on GitHub
#!/usr/bin/env python3
"""Create an optional overview or four-slide readability review package."""

from __future__ import annotations

import argparse
import hashlib
import json
import math
import sys
from datetime import datetime, timezone
from pathlib import Path
from typing import Any

from make_contact_sheet import build_contact_sheet, collect_images
from render_deck_overview import render_with_powerpoint


MODES = ("off", "overview", "full")


def create_package(
    mode: str,
    output_dir: Path,
    *,
    pptx: Path | None = None,
    slides_dir: Path | None = None,
    dpi: int = 120,
    group_size: int = 4,
) -> dict[str, Any]:
    if mode not in MODES:
        raise ValueError(f"unsupported readability mode: {mode}")
    if not 1 <= group_size <= 4:
        raise ValueError("group_size must be between 1 and 4")
    output_dir = output_dir.resolve()
    output_dir.mkdir(parents=True, exist_ok=True)
    evidence_files: list[str] = []
    rendered_count = 0

    if mode != "off":
        if bool(pptx) == bool(slides_dir):
            raise ValueError("choose exactly one of pptx or slides_dir")
        if pptx:
            pptx = pptx.resolve()
            rendered_dir = output_dir / "rendered-slides"
            render_with_powerpoint(pptx, rendered_dir, dpi)
        else:
            rendered_dir = slides_dir.resolve()
        images = collect_images(rendered_dir)
        if not images:
            raise ValueError("no rendered slide images found")
        rendered_count = len(images)
        if mode == "overview":
            overview = output_dir / "overview.png"
            build_contact_sheet(images, overview)
            evidence_files.append(str(overview))
        else:
            groups_dir = output_dir / "groups"
            for offset in range(0, len(images), group_size):
                group = images[offset : offset + group_size]
                group_path = groups_dir / f"group-{offset // group_size + 1:02d}.png"
                build_contact_sheet(
                    group,
                    group_path,
                    columns=2 if len(group) > 1 else 1,
                    thumb_width=1000,
                    start_index=offset + 1,
                )
                evidence_files.append(str(group_path))

    manifest = {
        "schema_version": "0.1",
        "generated_at": datetime.now(timezone.utc).isoformat(),
        "mode": mode,
        "pptx": str(pptx) if pptx else None,
        "pptx_sha256": hashlib.sha256(pptx.read_bytes()).hexdigest() if pptx else None,
        "rendered_slide_count": rendered_count,
        "group_size": group_size if mode == "full" else None,
        "evidence_files": evidence_files,
        "expected_review_calls": math.ceil(rendered_count / group_size) if mode == "full" else (1 if mode == "overview" else 0),
    }
    manifest_path = output_dir / "manifest.json"
    manifest_path.write_text(json.dumps(manifest, ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
    manifest["manifest"] = str(manifest_path)
    return manifest


def main() -> int:
    parser = argparse.ArgumentParser(description=__doc__)
    parser.add_argument("--mode", choices=MODES, default="off")
    source = parser.add_mutually_exclusive_group()
    source.add_argument("--pptx", type=Path)
    source.add_argument("--slides-dir", type=Path)
    parser.add_argument("-o", "--output-dir", type=Path, required=True)
    parser.add_argument("--dpi", type=int, default=120)
    parser.add_argument("--group-size", type=int, default=4)
    args = parser.parse_args()
    try:
        result = create_package(
            args.mode,
            args.output_dir,
            pptx=args.pptx,
            slides_dir=args.slides_dir,
            dpi=args.dpi,
            group_size=args.group_size,
        )
    except (OSError, RuntimeError, ValueError) as exc:
        print(f"ERROR: {exc}", file=sys.stderr)
        return 1
    print(
        f"Readability package: {result['mode']} | {result['rendered_slide_count']} slides | "
        f"{result['expected_review_calls']} review image(s) | {result['manifest']}"
    )
    return 0


if __name__ == "__main__":
    raise SystemExit(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: 472kUpdated 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: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated 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: 196kUpdated Claude CodeCodexVerifiedInstall