Source To Editable PPTX
Turn an authorized source document into an editable presentation while keeping every content slide traceable to source line numbers.
Use This Skill When
- - A user wants a long document, report, brief, or meeting record converted to PPTX.
- The result must remain editable instead of becoming slide images.
- Reviewers need to know which source lines support each slide.
- A speaker-notes draft and a factual review checklist are required.
Do not use it to invent missing financial, legal, medical, performance, or customer claims. Ask for the source material or clearly mark missing evidence.
Preconditions
- 1. Confirm that the input is user-owned or user-authorized.
- Remove material that should not be placed in a presentation.
- Install the local dependency with
python -m pip install -r requirements.txt. - Keep confidential material local unless the user separately authorizes an external upload.
Inputs
- - One UTF-8 Markdown or text file.
- Optional deck title and subtitle.
- Theme:
business, report, or education. - Optional
--keep-sensitive only when the user explicitly wants emails, phone numbers, or key-like strings preserved.
Outputs
- - A real
.pptx with editable titles, bullets, shapes, and footer labels. - INLINECODE6 with slide numbers and source line ranges.
- INLINECODE7 with a short narration draft and review prompts.
Three-Step Workflow
- 1. Prepare: structure the source with one
# deck title and ## section headings; retain claims and numbers exactly as provided. - Generate: run the script, which redacts common sensitive patterns by default, splits dense sections, and writes the PPTX plus sidecars.
- Verify: reopen the PPTX, compare the source map with the original lines, and manually review names, dates, amounts, conclusions, and permissions.
Run
CODEBLOCK0
For a large source, lower --max-bullets or --max-chars to create more slides instead of shrinking text.
Acceptance
- - The PPTX can be reopened by
python-pptx without repair errors. - Every source-derived content slide has a non-empty source line range.
- Slide text remains editable and is not flattened into images.
- No slide exceeds the configured bullet and character limits.
- Emails, phone numbers, tokens, and private-key markers are absent unless
--keep-sensitive was explicitly used. - The final review slide reminds the presenter to check facts, permissions, and sensitive content.
Error Recovery
- -
ModuleNotFoundError: pptx: install requirements.txt with the same Python executable used to run the script. - Garbled Chinese: save the source as UTF-8 and use a Chinese-capable font such as Microsoft YaHei.
- A section is too dense: reduce
--max-bullets or --max-chars, then rerun. - A slide has no source lines: check that its section contains text under a Markdown heading.
- PowerPoint reports repair: delete the output, upgrade
python-pptx, regenerate, and run the package validator before delivery.
Privacy And Permission Boundaries
- - Processing is local; the script makes no network requests.
- Redaction is best-effort, not a substitute for a human privacy review.
- Do not present model-generated summaries as audited facts.
- Do not upload private source documents, generated decks, or speaker notes without explicit authorization.