powerpoint - SKILL.md Agent Skill

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.