| name | office-pptx |
| description | Use when the user asks to create, inspect, verify, polish, or deliver PowerPoint `.pptx` decks, Google Slides-targeted deck artifacts, strategy narratives, operating reviews, pitch decks, teaching decks, section slides, bullet slides, or source-to-PPTX transformations. |
| requires | {"bins":["python3"]} |
| install | [{"kind":"brew","formula":"python","bins":["python3"],"label":"Install Python 3 via Homebrew","os":["darwin"]}] |
| allowed-tools | ["read","write","edit","apply_patch","exec","ls","grep","pdf","web_search","web_fetch","image_generate","send_attachment"] |
Office PPTX
Use the bundled scripts in this skill package to produce editable .pptx
decks. The builder writes editable text boxes, image placements, metric cards,
tables, timelines, drawn proof charts, and native PowerPoint chart objects. The
skill activation metadata includes Skill directory; treat that as SKILL_DIR
and run scripts from SKILL_DIR/scripts/.
Story First
Before building slides, identify:
- Audience and decision context.
- Claim spine: what each slide proves.
- Required proof objects: table, metric, comparison, workflow, timeline, or
narrative slide.
- Visual rhythm: title, section, bullets, two-column, and appendix slides.
Every slide should have one job.
Workflow
- Draft the slide list and title-level claims.
- For explicit control, convert each slide into a structured slide object and
run:
python3 "$SKILL_DIR/scripts/check_env.py"
python3 "$SKILL_DIR/scripts/build_pptx.py" --spec spec.json --out output.pptx
python3 "$SKILL_DIR/scripts/inspect_pptx.py" --verify output.pptx
python3 "$SKILL_DIR/scripts/layout_audit.py" output.pptx
- For a Markdown outline, use
# Deck title, ## Slide title, ## Section: Name, and bullet lists, then run:
python3 "$SKILL_DIR/scripts/outline_to_pptx.py" --outline outline.md --out output.pptx
python3 "$SKILL_DIR/scripts/inspect_pptx.py" --verify output.pptx
- If visual QA matters and LibreOffice is available, run:
python3 "$SKILL_DIR/scripts/render_preview.py" output.pptx
- To append slides to an existing deck without rebuilding it:
python3 "$SKILL_DIR/scripts/append_pptx.py" --input existing.pptx --spec append.json --out output.pptx
python3 "$SKILL_DIR/scripts/inspect_pptx.py" --verify output.pptx
python3 "$SKILL_DIR/scripts/layout_audit.py" output.pptx --reference existing.pptx
- For targeted edits to an existing deck, patch text in place to preserve the
source package, theme, layouts, media, and animations:
python3 "$SKILL_DIR/scripts/patch_pptx.py" --input existing.pptx --patch patch.json --out output.pptx
python3 "$SKILL_DIR/scripts/layout_audit.py" output.pptx --reference existing.pptx
Patch shape:
{"replace_text": [{"old": "Old title", "new": "New title"}]}
- For template-following or source-deck workflows, duplicate, drop, or reorder
source slides without rebuilding their XML:
python3 "$SKILL_DIR/scripts/duplicate_slide.py" --input template.pptx --slide 2 --out duplicated.pptx
python3 "$SKILL_DIR/scripts/deck_reorder.py" --input duplicated.pptx --order '[2,1,3]' --out reordered.pptx
python3 "$SKILL_DIR/scripts/layout_audit.py" reordered.pptx --reference template.pptx
- After rendering previews, create a contact sheet when reviewing slide rhythm:
python3 "$SKILL_DIR/scripts/make_contact_sheet.py" --images preview/page-*.png --out contact-sheet.html
- Deliver the
.pptx path or attach it with send_attachment.
Spec Shape
{
"title": "Deck title",
"slides": [
{"type": "title", "title": "Board Update", "subtitle": "Q2"},
{"type": "section", "title": "What changed"},
{"type": "bullets", "title": "Retention improved", "bullets": ["Activation rose", "Churn fell"]},
{"type": "metrics", "title": "Operating pulse", "metrics": [{"label": "ARR", "value": "$12M", "delta": "+18%"}]},
{"type": "table", "title": "Options", "headers": ["Option", "Pros", "Risks"], "rows": [["A", "Fast", "Low moat"]]},
{"type": "timeline", "title": "Launch path", "items": [{"date": "Q1", "label": "Pilot"}, {"date": "Q2", "label": "GA"}]},
{"type": "chart", "title": "Segment mix", "data": [{"label": "SMB", "value": 42}, {"label": "Enterprise", "value": 58}]},
{"type": "native_chart", "title": "Native segment mix", "chart_type": "pie", "data": [{"label": "SMB", "value": 42}, {"label": "Enterprise", "value": 58}]},
{"type": "image", "title": "Product screenshot", "image": "screenshot.png", "caption": "Use verified assets only"},
{"type": "two_column", "title": "Options", "left": ["Option A"], "right": ["Option B"]}
]
}
Quality Bar
- Use concise slide titles with a claim, not just a topic label.
- Keep bullets short; move dense material into an appendix or document.
- Avoid invented logos, marks, screenshots, or metrics. Use verified assets or
omit them.
- Use
native_chart when the deck needs a real editable PowerPoint chart
object; use chart only for quick drawn proof-object slides.
- Preserve source-deck style when the user asks for edits to an existing deck;
use
patch_pptx.py for text-only edits and minimal local changes rather
than rebuilding from scratch.
- When duplicating, dropping, or reordering slides, preserve non-slide
presentation relationships such as slide masters, layouts, themes, and view
properties; do not rebuild
presentation.xml.rels from slides only.
- Run the layout audit (
layout_audit.py) before delivery; fix blank slides,
missing titles, dense text, and out-of-bounds shapes. Preserve source-deck
style for template and targeted-edit work.
- If preview rendering fails because LibreOffice or a PDF-to-PNG renderer is
missing, state exactly which verification passed; do not imply visual QA
passed.