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

references/environment-compatibility.md

View on GitHub
# Environment compatibility

## Capability preflight

Run `paper_ppt.py preflight` before visual routing. The script automatically records host tools and Python modules. Pass the agent-session states for `--imagegen` and `--web-search`; these capabilities cannot be inferred reliably from installed files or environment variables.

Treat `unknown` as unresolved, not as a reason to repeatedly invoke a missing tool. After one definitive unavailable or authentication failure, record `unavailable` and follow the reported route:

```text
imagegen -> external_image -> tikz_or_none
```

The fallback changes only conceptual imagery. Paper evidence still uses `paper_asset`, `data_redraw`, or a clearly labeled TikZ synthesis.

## Browser rendering

Prefer an explicit `--browser` or `PAPER_PPT_BROWSER` in managed environments. Otherwise the renderer searches PATH and common Chromium-family install locations on Windows, macOS, and Linux.

The renderer uses two bounded attempts per browser:

1. Modern Chromium headless mode with conservative flags.
2. Legacy/compatibility headless mode with GPU and Vulkan/Skia workarounds.

Each attempt defaults to a 30-second timeout. A timeout terminates the browser process tree and skips the second strategy for that browser, preventing a blocked desktop or sandbox session from multiplying retries. Override the timeout only for demonstrably slow CI hosts.

It uses a unique browser profile and a writable temporary directory near the requested output before falling back to the system temp directory. Set `--temp-dir` when policy requires a specific location. `--no-sandbox` is never automatic; enable `--allow-no-sandbox` only inside an isolated CI container.

## PowerPoint rendering

Detecting `POWERPNT.EXE` proves installation, not COM runtime access. Desktop-session, sandbox, and service-account restrictions may still block export. Keep overview rendering separate from the core build and fall back in this order: PowerPoint, LibreOffice, OfficeCLI, then an explicitly incomplete text/HTML check.

## PowerShell and UTF-8

- Prefer PowerShell 7 (`pwsh`) for new automation.
- Windows PowerShell 5.1 may parse UTF-8 files without a BOM using the active code page. Keep `.ps1` source ASCII when practical, or save non-ASCII scripts as UTF-8 with BOM.
- Read and write JSON with explicit UTF-8 APIs. Do not round-trip structured JSON through default `Get-Content | Set-Content` encoding.
- Keep user-visible non-ASCII strings in UTF-8 JSON or HTML resources when a PowerShell helper can remain ASCII.
- Invoke Python through `sys.executable` from Python orchestration so the same interpreter and environment are preserved.
- On Windows locales where a third-party Python utility calls `Path.read_text()` without an explicit encoding, run it with `PYTHONUTF8=1`. The bundled paper-PPT scripts already specify UTF-8 for their text and JSON files.
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