Skip to content

SlideSpeak/skills

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 

Repository files navigation

SlideSpeak Agent Skills & MCP — AI-Powered Presentation Generation

SlideSpeak is an AI presentation platform that lets you generate, edit, and automate PowerPoint (PPTX) files from plain text, documents, or structured data — without touching slide design manually.

This repository contains the official SlideSpeak Agent Skill for AI coding environments and agentic platforms. For the SlideSpeak MCP server, see SlideSpeak/slidespeak-mcp.


What Is SlideSpeak?

SlideSpeak provides an AI presentation API and a set of developer-facing tools — an MCP server and agent skills — that let autonomous agents and human developers generate polished PowerPoint presentations programmatically.

Core capabilities:

  • Generate a PPTX from a topic, document, or prompt
  • Edit existing presentations slide-by-slide via API
  • Apply branded templates and control layout, tone, and length
  • Integrate presentation generation into any agentic workflow

SlideSpeak is used by 500+ companies to automate sales decks, financial reports, executive summaries, and training materials.


SlideSpeak Agent Skill

The SlideSpeak Agent Skill gives AI agents (Claude, OpenClaw, LobeHub, and similar agentic systems) structured access to SlideSpeak's presentation generation API as a reusable, composable skill.

What the Skill Does

Action Description
Generate presentation Create a full PPTX from a text prompt or document
Edit slide Insert, update, or remove individual slides from an existing deck
Check task status Poll an async generation task by task_id
Download result Retrieve the .pptx download URL once complete

Presentation generation typically takes 30–60 seconds. The skill handles polling automatically by default; pass --no-wait to return a task_id and poll manually.

Setup

Requirement: Set the SLIDESPEAK_API_KEY environment variable. Get your key at slidespeak.co/slidespeak-api.

export SLIDESPEAK_API_KEY=your-api-key-here

The skill uses the helper script at scripts/slidespeak.mjs.

Usage Examples

Generate a presentation from a prompt:

node scripts/slidespeak.mjs generate \
  --topic "Q3 Marketing Results" \
  --length 10 \
  --tone professional

Edit an existing slide:

node scripts/slidespeak.mjs edit-slide \
  --presentation-id "abc123" \
  --type INSERT \
  --position 5 \
  --prompt "Add a slide about quarterly revenue growth with charts"

Check generation status:

node scripts/slidespeak.mjs status <task_id>

Available Platforms

The SlideSpeak Agent Skill is available on:

  • OpenClaw (formerly ClawdBot) — View skill on OpenClaw
  • LobeHub Skills MarketplaceView on LobeHub
  • This repository — clone and use directly in any Node.js-based agent environment

SlideSpeak MCP Server

The SlideSpeak MCP (Model Context Protocol) server lets MCP-compatible AI clients — including Claude Desktop, Claude Code, and Cursor — generate PowerPoint presentations from natural language, without leaving the chat interface.

MCP server repository: SlideSpeak/slidespeak-mcp

Quick Setup: Claude Desktop (Remote, Recommended)

The simplest way — no Docker required. Requires Node.js.

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "slidespeak": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.slidespeak.co/mcp",
        "--header",
        "Authorization: Bearer YOUR-SLIDESPEAK-API-KEY-HERE"
      ],
      "timeout": 300000
    }
  }
}

Quick Setup: Docker

{
  "mcpServers": {
    "slidespeak": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "SLIDESPEAK_API_KEY", "slidespeak/slidespeak-mcp:latest"],
      "env": {
        "SLIDESPEAK_API_KEY": "YOUR-SLIDESPEAK-API-KEY-HERE"
      }
    }
  }
}

Quick Setup: Claude Code

claude mcp add-json "slidespeak" '{"command":"docker","args":["run","-i","--rm","-e","SLIDESPEAK_API_KEY","slidespeak/slidespeak-mcp:latest"],"env":{"SLIDESPEAK_API_KEY":"YOUR-API-KEY-HERE"}}'

Using the MCP in Claude

Once configured, you can prompt Claude naturally:

  • "Create a 10-slide presentation about our Q3 marketing results."
  • "Turn this PDF summary into a PowerPoint deck."
  • "Generate a sales proposal for [Company] based on this conversation."

Claude will call the SlideSpeak MCP, handle generation, and return a downloadable .pptx link — all without leaving the chat.


Why Use SlideSpeak for AI Agents?

Feature SlideSpeak
Output format Fully editable .pptx
Input types Text prompt, document, structured data
Template support ✅ Custom branded templates
Tone & length control professional, casual, educational, sales_pitch, concise / text-heavy
Async task handling task_id polling for long-running jobs
MCP support ✅ Remote + Docker
Agent Skill support ✅ OpenClaw, LobeHub, custom
REST API ✅ Full Postman collection available

Common Use Cases

Business automation: Auto-generate weekly sales reports, board updates, and executive summaries as slide decks on a schedule.

Agentic workflows: Let an AI research a topic, synthesize findings, and produce a stakeholder-ready presentation in a single pipeline — no human formatting required.

SaaS embedding: Add presentation export to your own product. Users can export dashboards, reports, or analytics directly as PPTX files.

Education: Generate curriculum slides and lesson decks from course content or learning objectives.

Sales: Create personalised pitch decks from CRM data or conversation context, at scale.


API & Documentation


Frequently Asked Questions

What AI clients does the SlideSpeak MCP work with?
Claude Desktop, Claude Code, Cursor, and any other client that supports the Model Context Protocol (MCP).

Do I need Docker to use the MCP?
No. The recommended setup uses npx mcp-remote with a remote connection to https://mcp.slidespeak.co/mcp — no Docker needed.

How long does presentation generation take?
Typically 30–60 seconds. Both the MCP and the Agent Skill handle async polling internally so you don't have to wait manually.

What file format does SlideSpeak output?
Standard .pptx files, fully editable in Microsoft PowerPoint, Google Slides, and Keynote.

Can I use my own branded templates?
Yes. The SlideSpeak API supports custom templates. See the API documentation for details.

What is the difference between the MCP and the Agent Skill?
The MCP server connects SlideSpeak to MCP-compatible chat clients (Claude, Cursor) so end-users can generate presentations in conversation. The Agent Skill is a composable tool for AI coding agents and agentic platforms (OpenClaw, LobeHub) that need programmatic, CLI-level access to SlideSpeak's API within a multi-step workflow.


License

See LICENSE for details.


SlideSpeak — AI presentations for developers, agents, and teams. slidespeak.co

About

SlideSpeak Agent Skills to create presentations using SlideSpeak API

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors