# slidespeak

SkillBoss API Hub Presentation Skill This skill enables you to create and edit PowerPoint presentations using the SkillBoss API Hub.

IMPORTANT: Timing Behavior

Presentation generation takes 30-60 seconds. Option 1: Wait for completion (default) Run the command and wait. The script polls internally until complete: 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 If you cannot wait for the command to complete, use --no-wait: node scripts/slidespeak.mjs generate --text "Topic" --no-wait Returns immediately with: { "success": true, "data": { "task_id": "abc123...", "message": "Task started. Check status with: node scripts/slidespeak.mjs status abc123..." } } Then poll the status until complete: node scripts/slidespeak.mjs status When task_status is SUCCESS, use the request_id to download. Timeout behavior If the script times out while waiting, it returns the task_id so you can continue polling: { "success": true, "data": { "complete": false, "task_id": "abc123...", "task_status": "STARTED", "message": "Task still processing. Check status with: node scripts/slidespeak.mjs status abc123..." } } Setup The SKILLBOSS_API_KEY environment variable must be set. 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 node scripts/slidespeak.mjs generate --text "Your topic or content" --length 6

Options:

--text (required): Topic or content for the presentation

--length: Number of slides (default: 10)
--template: Template name or ID (default: "default")
--language: Output language (default: "ORIGINAL")
--tone: casual, professional, funny, educational, sales_pitch
--verbosity: concise, standard, text-heavy
--no-images: Disable stock image fetching
--no-cover: Exclude cover slide
--no-toc: Exclude table of contents

Generate from an Uploaded Document First upload the document, then generate:

# Upload a document (PDF, DOCX, PPTX, etc.)

node scripts/slidespeak.mjs upload /path/to/document.pdf

# Use the returned document_uuid to generate

node scripts/slidespeak.mjs generate --document --length 10 Supported formats: .pdf, .docx, .doc, .pptx, .ppt, .xlsx, .txt, .md List Available Templates

# Default templates

node scripts/slidespeak.mjs templates

# Branded templates (if configured)

node scripts/slidespeak.mjs templates --branded Download a Presentation After generation completes, use the request_id to download: node scripts/slidespeak.mjs download Returns a JSON object with a short-lived download URL. Edit an Existing Presentation Edit slides in an existing presentation:

# Insert a new slide at position 2

node scripts/slidespeak.mjs edit-slide
--presentation-id
--type INSERT
--position 2
--prompt "Content about market analysis"

# Regenerate slide at position 3

node scripts/slidespeak.mjs edit-slide
--presentation-id
--type REGENERATE
--position 3
--prompt "Updated content for this slide"

# Remove slide at position 4

node scripts/slidespeak.mjs edit-slide
--presentation-id
--type REMOVE
--position 4 Edit types:

INSERT: Add a new slide at the position
REGENERATE: Replace existing slide content
REMOVE: Delete the slide (no prompt needed)

Check Task Status For debugging or manual polling: node scripts/slidespeak.mjs status Get Account Info node scripts/slidespeak.mjs me Slide-by-Slide Generation For precise control over each slide, use the slide-by-slide endpoint. See references/API.md for the full schema. node scripts/slidespeak.mjs generate-slides --config slides.json Where slides.json contains: { "slides": [ {"title": "Introduction", "layout": "title", "content": "Welcome message"}, {"title": "Key Points", "layout": "bullets", "item_amount": 4, "content": "Main discussion points"} ], "template": "default" } Webhooks Subscribe to receive notifications when tasks complete:

# Subscribe

node scripts/slidespeak.mjs webhook-subscribe --url "https://your-webhook.com/endpoint"

# Unsubscribe

node scripts/slidespeak.mjs webhook-unsubscribe --url "https://your-webhook.com/endpoint" Error Handling The script outputs JSON with either:

Success: {"success": true, "data": {...}}
Error: {"success": false, "error": "message"}

Common Workflows Create a presentation about a topic node scripts/slidespeak.mjs generate --text "Introduction to Machine Learning" --length 8 --tone educational Create a presentation from a PDF report

# Upload the PDF

RESULT=$(node scripts/slidespeak.mjs upload report.pdf) DOC_ID=$(echo $RESULT | jq -r '.data.document_uuid')

# Generate presentation

node scripts/slidespeak.mjs generate --document "$DOC_ID" --length 12 Edit a presentation to add a new slide node scripts/slidespeak.mjs edit-slide
--presentation-id "abc123"
--type INSERT
--position 5
--prompt "Add a slide about quarterly revenue growth with charts" Additional Resources For detailed API documentation including all parameters, layout types, and constraints, read references/API.md.