Presentations
For questions about a deck, inspect it without editing. For a new deck, establish audience, purpose, required facts and any template before authoring. Follow explicit slide counts and ordering. A deck supplied only as a source of facts does not automatically define the new design.
Environment
Use run_command for local authoring, read_document for text, and view_pdf_page or view_image for visual review. Keep source decks intact. Store the requested PPTX in .artifacts/<task>/final/ and QA outputs separately inside the workspace. Resolve scripts relative to the Skill directory from load_skill.
Verify an existing Python with -c 'import pptx; import sys; print(sys.executable)'. If needed, check project .venv/bin/python or another configured Python environment. Use that absolute executable. Find soffice on PATH or the selected runtime's dependencies/bin/override/soffice; on macOS an installed LibreOffice may be under /Applications/LibreOffice.app/Contents/MacOS/soffice. Follow current approvals for missing dependencies.
Authoring
- Read design and authoring. For an existing deck, render the relevant source slides and inspect slide size, placeholders, masters, theme, fonts, logos and crops. Edit the source copy in place; change a master only if all affected slides should change.
- Use
python-pptx for supported native text, images, tables and charts. Inspect unsupported native features before saving an existing file; for complex templates, use targeted OOXML edits instead of reconstructing the deck. Reopening a deck is not proof that every native feature survived.
- Give each slide a clear subject and one main purpose. Use factual titles, concise wording, aligned content and enough whitespace. Preserve required evidence and editable objects. Split content or adjust layout before reducing type below readable sizes.
- Keep charts and tables native. Match source categories, series, signs, units and date periods. Calculate totals from source values. Add actual sources to speaker notes; keep disclosures visible when the audience needs them. Use supplied visual assets without distorting proportions.
- Run package and geometry checks:
<python> <skill-directory>/scripts/inspect-slides.py <output.pptx>
Review every reported off-slide object and missing relationship. Bounds do not detect text overflow or establish visual fidelity.
- Convert the finished deck to a PDF using the isolated LibreOffice command in the reference. Verify slide/page counts, inspect every page, fix overlaps, clipping, tiny text, blank charts and missing assets, then repeat affected checks.
- Reopen the PPTX and verify requested notes, chart series and tables. Deliver the editable PPTX with a file link. PDF/PNG previews are QA assets unless requested.
A Google Slides result requires an available authenticated upload/import action. A local PPTX is a local deliverable, not a completed cloud presentation. Disclose target-application checks that could not be performed.
Advanced local operations
For advanced edits, template preservation and format-specific validation, read advanced workflow. Read only the sections relevant to the task.
Dependency setup
If the verified interpreter lacks required modules, create an isolated environment inside the workspace with python3 -m venv .artifacts/document-runtime and install this Skill's requirements.txt using that environment's python -m pip install -r <skill-directory>/requirements.txt, subject to the current command approval policy. Reuse the verified environment for subsequent calls. LibreOffice and Poppler are native dependencies: locate existing executables first; if absent, install through the platform package manager under the current policy and verify soffice --version and pdftoppm -v. Never treat missing dependencies as a successful render/recalculation.
1---2name: presentations3description: Create and edit editable PPTX slide decks with template preservation, native charts and tables, and per-slide visual verification.4---56# Presentations78For questions about a deck, inspect it without editing. For a new deck, establish audience, purpose, required facts and any template before authoring. Follow explicit slide counts and ordering. A deck supplied only as a source of facts does not automatically define the new design.910## Environment1112Use `run_command` for local authoring, `read_document` for text, and `view_pdf_page` or `view_image` for visual review. Keep source decks intact. Store the requested PPTX in `.artifacts/<task>/final/` and QA outputs separately inside the workspace. Resolve scripts relative to the Skill directory from `load_skill`.1314Verify an existing Python with `-c 'import pptx; import sys; print(sys.executable)'`. If needed, check project `.venv/bin/python` or another configured Python environment. Use that absolute executable. Find `soffice` on PATH or the selected runtime's `dependencies/bin/override/soffice`; on macOS an installed LibreOffice may be under `/Applications/LibreOffice.app/Contents/MacOS/soffice`. Follow current approvals for missing dependencies.1516## Authoring17181. Read [design and authoring](references/authoring.md). For an existing deck, render the relevant source slides and inspect slide size, placeholders, masters, theme, fonts, logos and crops. Edit the source copy in place; change a master only if all affected slides should change.192. Use `python-pptx` for supported native text, images, tables and charts. Inspect unsupported native features before saving an existing file; for complex templates, use targeted OOXML edits instead of reconstructing the deck. Reopening a deck is not proof that every native feature survived.203. Give each slide a clear subject and one main purpose. Use factual titles, concise wording, aligned content and enough whitespace. Preserve required evidence and editable objects. Split content or adjust layout before reducing type below readable sizes.214. Keep charts and tables native. Match source categories, series, signs, units and date periods. Calculate totals from source values. Add actual sources to speaker notes; keep disclosures visible when the audience needs them. Use supplied visual assets without distorting proportions.225. Run package and geometry checks:23 ```text24 <python> <skill-directory>/scripts/inspect-slides.py <output.pptx>25 ```26 Review every reported off-slide object and missing relationship. Bounds do not detect text overflow or establish visual fidelity.276. Convert the finished deck to a PDF using the isolated LibreOffice command in the reference. Verify slide/page counts, inspect every page, fix overlaps, clipping, tiny text, blank charts and missing assets, then repeat affected checks.287. Reopen the PPTX and verify requested notes, chart series and tables. Deliver the editable PPTX with a file link. PDF/PNG previews are QA assets unless requested.2930A Google Slides result requires an available authenticated upload/import action. A local PPTX is a local deliverable, not a completed cloud presentation. Disclose target-application checks that could not be performed.3132## Advanced local operations3334For advanced edits, template preservation and format-specific validation, read [advanced workflow](references/advanced-workflows.md). Read only the sections relevant to the task.3536## Dependency setup3738If the verified interpreter lacks required modules, create an isolated environment inside the workspace with `python3 -m venv .artifacts/document-runtime` and install this Skill's `requirements.txt` using that environment's `python -m pip install -r <skill-directory>/requirements.txt`, subject to the current command approval policy. Reuse the verified environment for subsequent calls. LibreOffice and Poppler are native dependencies: locate existing executables first; if absent, install through the platform package manager under the current policy and verify `soffice --version` and `pdftoppm -v`. Never treat missing dependencies as a successful render/recalculation.