powerpoint

name	powerpoint
description	Create, edit, and manipulate PowerPoint presentations from the command line. Add slides, text, images, tables, charts, shapes, and apply professional designs. Use when the user wants to create or modify .pptx files.

PowerPoint CLI

For installation and requirements, see README.md.

Batch Mode (recommended)

The server is stateful — create a presentation, then build it up, then save. Use the batch runner to execute multiple commands in a single session:

echo '<json>' | bun ~/.pi/agent/skills/powerpoint/powerpoint-batch.ts
bun ~/.pi/agent/skills/powerpoint/powerpoint-batch.ts recipe.json
bun ~/.pi/agent/skills/powerpoint/powerpoint-batch.ts --recipe '<json>'

Input format — a JSON object with a commands array:

{
  "commands": [
    { "tool": "create_presentation" },
    { "tool": "add_slide", "args": { "title": "Hello World" } },
    { "tool": "manage_text", "args": { "slide_index": 0, "operation": "add", "left": 1, "top": 2, "width": 8, "height": 1, "text": "Body text", "font_size": 18 } },
    { "tool": "save_presentation", "args": { "file_path": "./output.pptx" } }
  ]
}

Output: JSON array of { tool, result } objects (or { tool, error } on failure).

The batch runner auto-injects presentation_id into all commands after create_presentation/open_presentation, so you don't need to track it yourself.

Single-Command Mode

For one-off read operations, use the single-command CLI:

bun ~/.pi/agent/skills/powerpoint/powerpoint-cli.js <command> [flags]
bun ~/.pi/agent/skills/powerpoint/powerpoint-cli.js --help

Useful for inspection commands that don't need state:

bun <cli> list-slide-templates
bun <cli> get-template-info --template-id title_slide
bun <cli> get-server-info

Available Tools

Lifecycle

• create_presentation — create empty presentation
• create_presentation_from_template — create from .pptx template: { "template_path": "./template.pptx" }
• open_presentation — open existing file: { "file_path": "./deck.pptx" }
• save_presentation — save to file: { "file_path": "./output.pptx" }
• get_presentation_info — slide count, dimensions, properties
• set_core_properties — set title, author, keywords, etc.

Slides

• add_slide — add a slide: { "layout_index": 1, "title": "Slide Title" }
  • layout_index: 0=Title, 1=Title+Content, 2=Section, 5=Blank, etc.
  • Optional: background_type ("solid"/"gradient"), background_colors, color_scheme
• get_slide_info — shapes, layout info: { "slide_index": 0 }
• extract_slide_text — all text from a slide: { "slide_index": 0 }
• extract_presentation_text — all text from all slides

Text Content

• populate_placeholder — fill a layout placeholder: { "slide_index": 0, "placeholder_idx": 1, "text": "Hello" }
• add_bullet_points — bullets in a placeholder: { "slide_index": 0, "placeholder_idx": 1, "bullet_points": ["A", "B", "C"] }
• manage_text — add/format text boxes:

  { "slide_index": 0, "operation": "add", "left": 1, "top": 2, "width": 8, "height": 1, "text": "Hello", "font_size": 24, "bold": true, "color": [0, 0, 0] }
  

  Operations: add, format, validate, format_runs

Images

• manage_image — add/enhance images:

  { "slide_index": 0, "operation": "add", "image_source": "./photo.png", "left": 1, "top": 2, "width": 4, "height": 3 }
  

  source_type: "file" (default), "url", "base64"

Tables

• add_table — add a data table:

  { "slide_index": 0, "rows": 3, "cols": 4, "left": 1, "top": 2, "width": 8, "height": 3, "data": [["H1","H2","H3","H4"],["a","b","c","d"],["e","f","g","h"]] }
  

• format_table_cell — style a cell: { "slide_index": 0, "shape_index": 0, "row": 0, "col": 0, "bold": true, "bg_color": [68, 114, 196] }

Charts

• add_chart:

  { "slide_index": 0, "chart_type": "bar", "left": 1, "top": 2, "width": 8, "height": 4, "categories": ["Q1","Q2","Q3"], "series_names": ["Revenue"], "series_values": [[100, 200, 300]] }
  

  Note: series_values is an array of arrays (one inner array per series). Chart types: bar, column, line, pie, scatter, area, doughnut
• update_chart_data — replace data on existing chart

Shapes & Connectors

• add_shape:

  { "slide_index": 0, "shape_type": "rectangle", "left": 1, "top": 1, "width": 3, "height": 2, "fill_color": "4472C4", "text": "Box" }
  

  Types: rectangle, rounded_rectangle, oval, triangle, diamond, arrow_right, etc.
• add_connector — lines/arrows between points:

  { "slide_index": 0, "connector_type": "straight", "start_x": 2, "start_y": 3, "end_x": 6, "end_y": 3 }
  

Design & Styling

• apply_professional_design — apply themes: { "operation": "apply_theme", "color_scheme": "modern_blue" }
  • Operations: apply_theme, design_slide, enhance_slide
• apply_picture_effects — shadow, reflection, etc.
• optimize_slide_text — auto-resize fonts: { "slide_index": 0 }
• manage_fonts — analyze/optimize: { "operation": "analyze", "font_path": "./deck.pptx" }

Templates

• list_slide_templates — list available layout templates
• get_template_info — details about a template: { "template_id": "title_slide" }
• apply_slide_template — apply template to existing slide
• create_slide_from_template — new slide from template
• create_presentation_from_templates — full deck from template sequence
• auto_generate_presentation — auto-generate from topic:

  { "topic": "Q4 Results", "slide_count": 8, "presentation_type": "business", "color_scheme": "modern_blue" }
  

Other

• manage_hyperlinks — add/remove/list links
• manage_slide_transitions — set/remove transitions
• manage_slide_masters — inspect master layouts

Reference

• Positions (left, top) and sizes (width, height) are in inches. Standard slide is 10×7.5.
• Slide indices are 0-based.
• Colors: hex RGB without # for shape fills (e.g., "4472C4"), RGB arrays [r, g, b] for text/cell colors.
• Color schemes: modern_blue, corporate_gray, elegant_green, warm_red.
• Tool names accept both snake_case and kebab-case.