SlideSpeak Presentation Skill

This skill enables you to create and edit PowerPoint presentations using the SlideSpeak API.

IMPORTANT: Timing Behavior

Presentation generation takes 30-60 seconds.

Option 1: Wait for completion (default)

node scripts/slidespeak.mjs generate --text "Topic"

• - Blocks until the task finishes (typically 30-60 seconds)
• Returns the complete result with download URL

Option 2: Return immediately with --no-wait

node scripts/slidespeak.mjs generate --text "Topic" --no-wait

Then poll the status until complete:

node scripts/slidespeak.mjs status <task_id>

Timeout behavior

Setup

The SLIDESPEAK_API_KEY environment variable must be set. Get your API key from https://app.slidespeak.co/settings/developer

Quick Reference

All commands use the helper script at scripts/slidespeak.mjs. The script handles API authentication and waits for async tasks to complete automatically (no manual polling needed).

Generate a Presentation from Text

CODEBLOCK5

Options:

• - --text (required): Topic or content for the presentation
• INLINECODE8: Number of slides (default: 10)
• INLINECODE9: Template name or ID (default: "default")
• INLINECODE10: Output language (default: "ORIGINAL")
• INLINECODE11: casual, professional, funny, educational, sales_pitch
• INLINECODE12: concise, standard, text-heavy
• INLINECODE13: Disable stock image fetching
• INLINECODE14: Exclude cover slide
• INLINECODE15: Exclude table of contents

Generate from an Uploaded Document

First upload the document, then generate:

CODEBLOCK6

Supported formats: .pdf, .docx, .doc, .pptx, .ppt, .xlsx, .txt, INLINECODE23

List Available Templates

CODEBLOCK7

Download a Presentation

After generation completes, use the request_id to download:

CODEBLOCK8

Returns a JSON object with a short-lived download URL.

Edit an Existing Presentation

Edit slides in an existing presentation:

CODEBLOCK9

Edit types:

• - INSERT: Add a new slide at the position
• INLINECODE26: Replace existing slide content
• INLINECODE27: Delete the slide (no prompt needed)

Check Task Status

For debugging or manual polling:

CODEBLOCK10

Get Account Info

CODEBLOCK11

Slide-by-Slide Generation

For precise control over each slide, use the slide-by-slide endpoint. See references/API.md for the full schema.

CODEBLOCK12

Where slides.json contains:
CODEBLOCK13

Webhooks

Subscribe to receive notifications when tasks complete:

CODEBLOCK14

Error Handling

The script outputs JSON with either:

• - Success: INLINECODE30
• Error: INLINECODE31

Common Workflows

Create a presentation about a topic

Create a presentation from a PDF report

Edit a presentation to add a new slide

Additional Resources

For detailed API documentation including all parameters, layout types, and constraints, read references/API.md.