Office PowerPoint
Tool Route
Use the bundled Office tools as the default path. Do not install OfficeCLI or python-pptx when these tools are available.
- Use
read_files with one paths item for broad content inspection; use metadata_only:true when only prepared metadata is needed.
- Use
create_pptx for a straightforward new deck. Route a high-design presentation or full narrative strategy to the presentation-making workflow.
- Use
office_read with outline, get, or query to identify slides and shapes before editing.
- Pass the pre-existing source directly to
edit_office; it creates the
separate working copy. Use output_path in that one edit call when a
human-facing final name is desired.
- After every create or edit, use
office_review with action:"check_and_render" on every changed slide and representative unchanged slides.
The built-in engine supports .pptx, not legacy .ppt. Require conversion before editing a legacy file.
edit_office.operations accepts only set, add, and remove. After
office_read returns the exact stale shape path, remove it with this shape:
{
"path": "annual-review.pptx",
"output_path": "annual-review-cleaned.pptx",
"operations": [
{
"action": "remove",
"path": "/slide[4]/shape[3]"
}
]
}
Do not create the automatic -edited output and then copy or rename it with
bash, write_file, or another file tool. One requested final deck means one
new PPTX in the workspace and one published PPTX path.
Preservation Rules
- Inspect slide order, layouts, placeholders, masters, theme fonts/colors, notes, comments, charts, media, and transitions before editing an existing deck.
- Prefer stable element paths returned by
office_read; do not guess shape indices when a stable id or name is available.
- Preserve masters, layouts, relationships, notes, animations, media, and embedded data unless the user explicitly asks to change them.
- Treat global replacement as high impact. Use a precise target whenever possible and verify every changed slide.
- If the exposed tools cannot safely express a master, animation, embedded-object, or complex chart edit, report the limitation rather than silently flattening it.
Delivery Check
Check structure, issue output, template residue, slide text, notes, fonts, contrast, overflow, image quality, changed-slide renders, and the final path. A PNG preview does not prove animation, media playback, or exact PowerPoint/WPS fidelity.
Return the final .pptx path, the untouched source or backup path, changed slides, checks performed, and any target-viewer review still required.
1---2name: office-ppt3description: Office PowerPoint4---56# Office PowerPoint78## Tool Route910Use the bundled Office tools as the default path. Do not install OfficeCLI or `python-pptx` when these tools are available.1112- Use `read_files` with one `paths` item for broad content inspection; use `metadata_only:true` when only prepared metadata is needed.13- Use `create_pptx` for a straightforward new deck. Route a high-design presentation or full narrative strategy to the presentation-making workflow.14- Use `office_read` with `outline`, `get`, or `query` to identify slides and shapes before editing.15- Pass the pre-existing source directly to `edit_office`; it creates the16 separate working copy. Use `output_path` in that one edit call when a17 human-facing final name is desired.18- After every create or edit, use `office_review` with `action:"check_and_render"` on every changed slide and representative unchanged slides.1920The built-in engine supports `.pptx`, not legacy `.ppt`. Require conversion before editing a legacy file.2122`edit_office.operations` accepts only `set`, `add`, and `remove`. After23`office_read` returns the exact stale shape path, remove it with this shape:2425```json26{27 "path": "annual-review.pptx",28 "output_path": "annual-review-cleaned.pptx",29 "operations": [30 {31 "action": "remove",32 "path": "/slide[4]/shape[3]"33 }34 ]35}36```3738Do not create the automatic `-edited` output and then copy or rename it with39`bash`, `write_file`, or another file tool. One requested final deck means one40new PPTX in the workspace and one published PPTX path.4142## Preservation Rules43441. Inspect slide order, layouts, placeholders, masters, theme fonts/colors, notes, comments, charts, media, and transitions before editing an existing deck.452. Prefer stable element paths returned by `office_read`; do not guess shape indices when a stable id or name is available.463. Preserve masters, layouts, relationships, notes, animations, media, and embedded data unless the user explicitly asks to change them.474. Treat global replacement as high impact. Use a precise target whenever possible and verify every changed slide.485. If the exposed tools cannot safely express a master, animation, embedded-object, or complex chart edit, report the limitation rather than silently flattening it.4950## Delivery Check5152Check structure, issue output, template residue, slide text, notes, fonts, contrast, overflow, image quality, changed-slide renders, and the final path. A PNG preview does not prove animation, media playback, or exact PowerPoint/WPS fidelity.5354Return the final `.pptx` path, the untouched source or backup path, changed slides, checks performed, and any target-viewer review still required.