2slides – OpenClaw Skill

---

name: 2slides description: AI-powered presentation generation using 2slides API. Create slides from text content, match reference image styles, or summarize documents into presentations. Use when users request to "create a presentation", "make slides", "generate a deck", "create slides from this content/document/image", or any presentation creation task. Supports theme selection, multiple languages, and both synchronous and asynchronous generation modes.

2slides Presentation Generation

Generate professional presentations using the 2slides AI API. Supports content-based generation, style matching from reference images, and document summarization.

Setup Requirements

Users must have a 2slides API key:

1. Visit https://2slides.com/api to create an API key
2. Store the key in environment variable: SLIDES_2SLIDES_API_KEY

export SLIDES_2SLIDES_API_KEY="your_api_key_here"

Workflow Decision Tree

Choose the appropriate approach based on the user's request:

User Request
│
├─ "Create slides from this content/text"
│  └─> Use Content-Based Generation (Section 1)
│
├─ "Create slides like this image"
│  └─> Use Reference Image Generation (Section 2)
│
├─ "Create slides from this document"
│  └─> Use Document Summarization (Section 3)
│
└─ "Search for themes" or "What themes are available?"
   └─> Use Theme Search (Section 4)

---

1. Content-Based Generation

Generate slides from user-provided text content.

When to Use

• User provides content directly in their message
• User says "create a presentation about X"
• User provides structured outline or bullet points

Workflow

Step 1: Prepare Content

Structure the content clearly for best results:

Title: [Main Topic]

Section 1: [Subtopic]
- Key point 1
- Key point 2
- Key point 3

Section 2: [Subtopic]
- Key point 1
- Key point 2

Step 2: Choose Theme (Required)

Search for an appropriate theme (themeId is required):

python scripts/search_themes.py --query "business"
python scripts/search_themes.py --query "professional"
python scripts/search_themes.py --query "creative"

Pick a theme ID from the results.

Step 3: Generate Slides

Use the generate_slides.py script with the theme ID:

# Basic generation (theme ID required)
python scripts/generate_slides.py --content "Your content here" --theme-id "theme123"

# In different language
python scripts/generate_slides.py --content "Your content" --theme-id "theme123" --language "Spanish"

# Async mode for longer presentations
python scripts/generate_slides.py --content "Your content" --theme-id "theme123" --mode async

Step 4: Handle Results

Sync mode response:

{
  "slideUrl": "https://2slides.com/slides/abc123",
  "pdfUrl": "https://2slides.com/slides/abc123/download",
  "status": "completed"
}

Provide both URLs to the user:

• slideUrl: Interactive online slides
• pdfUrl: Downloadable PDF version

Async mode response:

{
  "jobId": "job123",
  "status": "pending"
}

Poll for results:

python scripts/get_job_status.py --job-id "job123"

---

2. Reference Image Generation

Generate slides that match the style of a reference image.

When to Use

• User provides an image URL and says "create slides like this"
• User wants to match existing brand/design style
• User has a template image they want to emulate

Workflow

Step 1: Verify Image URL

Ensure the reference image is:

• Publicly accessible URL
• Valid image format (PNG, JPG, etc.)
• Represents the desired slide style

Step 2: Generate Slides

Use the generate_slides.py script with --reference-image:

python scripts/generate_slides.py \
  --content "Your presentation content" \
  --reference-image "https://example.com/template.jpg" \
  --language "Auto"

Optional parameters:

--aspect-ratio "16:9"           # width:height format (e.g., "16:9", "4:3")
--resolution "2K"               # "1K", "2K" (default), or "4K"
--page 5                        # Number of slides (0 for auto-detection, max 100)
--content-detail "concise"      # "concise" (brief) or "standard" (detailed)

Note: This uses Nano Banana Pro mode with credit costs:

• 1K/2K: 100 credits per page
• 4K: 200 credits per page

Step 3: Handle Results

This mode always runs synchronously and returns:

{
  "slideUrl": "https://2slides.com/workspace?jobId=...",
  "pdfUrl": "https://...pdf...",
  "status": "completed",
  "message": "Successfully generated N slides",
  "slidePageCount": N
}

Provide both URLs to the user:

• slideUrl: View slides in 2slides workspace
• pdfUrl: Direct PDF download (expires in 1 hour)

Processing time: ~30 seconds per page (30-60 seconds typical for 1-2 pages)

---

3. Document Summarization

Generate slides from document content.

When to Use

• User uploads a document (PDF, DOCX, TXT, etc.)
• User says "create slides from this document"
• User wants to summarize long content into presentation format

Workflow

Step 1: Read Document

Use appropriate tool to read the document content:

• PDF: Use PDF reading tools
• DOCX: Use DOCX reading tools
• TXT/MD: Use Read tool

Step 2: Extract Key Points

Analyze the document and extract:

• Main topics and themes
• Key points for each section
• Important data, quotes, or examples
• Logical flow and structure

Step 3: Structure Content

Format extracted information into presentation structure:

Title: [Document Main Topic]

Introduction
- Context
- Purpose
- Overview

[Section 1 from document]
- Key point 1
- Key point 2
- Supporting detail

[Section 2 from document]
- Key point 1
- Key point 2
- Supporting detail

Conclusion
- Summary
- Key takeaways
- Next steps

Step 4: Generate Slides

Use content-based generation workflow (Section 1). First search for a theme, then generate:

# Search for appropriate theme
python scripts/search_themes.py --query "business"

# Generate with theme ID
python scripts/generate_slides.py --content "[Structured content from step 3]" --theme-id "theme123"

Tips:

• Keep slides concise (3-5 points per slide)
• Focus on key insights, not full text
• Use document headings as slide titles
• Include important statistics or quotes
• Ask user if they want specific sections highlighted

---

4. Theme Search

Find appropriate themes for presentations.

When to Use

• Before generating slides with specific styling
• User asks "what themes are available?"
• User wants professional or branded appearance

Workflow

Search themes:

# Search for specific style (query is required)
python scripts/search_themes.py --query "business"
python scripts/search_themes.py --query "creative"
python scripts/search_themes.py --query "education"
python scripts/search_themes.py --query "professional"

# Get more results
python scripts/search_themes.py --query "modern" --limit 50

Theme selection:

1. Show user available themes with names and descriptions
2. Ask user to choose or let them use default
3. Use the theme ID in generation request

---

Using the MCP Server

If the 2slides MCP server is configured in Claude Desktop, use the integrated tools instead of scripts.

Two Configuration Modes:

1. Streamable HTTP Protocol (Recommended)

   • Simplest setup, no local installation
   • Configure: "url": "https://2slides.com/api/mcp?apikey=YOUR_API_KEY"

2. NPM Package (stdio)

   • Uses local npm package
   • Configure: "command": "npx", "args": ["2slides-mcp"]

Available MCP tools:

• slides_generate - Generate slides from content
• slides_create_like_this - Generate from reference image
• themes_search - Search themes
• jobs_get - Check job status

See mcp-integration.md for complete setup instructions and detailed tool documentation.

When to use MCP vs scripts:

• Use MCP in Claude Desktop when configured
• Use scripts in Claude Code CLI or when MCP not available

---

Advanced Features

Sync vs Async Mode

Sync Mode (default):

• Waits for generation to complete (30-60 seconds)
• Returns results immediately
• Best for quick presentations

Async Mode:

• Returns job ID immediately
• Poll for results with get_job_status.py
• Best for large presentations or batch processing

Language Support

Generate slides in multiple languages (use full language name):

--language "Auto"                # Automatic detection (default)
--language "English"             # English
--language "Simplified Chinese"  # 简体中文
--language "Traditional Chinese" # 繁體中文
--language "Spanish"             # Español
--language "French"              # Français
--language "German"              # Deutsch
--language "Japanese"            # 日本語
--language "Korean"              # 한국어

And more: Arabic, Portuguese, Indonesian, Russian, Hindi, Vietnamese, Turkish, Polish, Italian

Error Handling

Common issues:

1. Missing API key

   Error: API key not found
   Solution: Set SLIDES_2SLIDES_API_KEY environment variable
   

2. Rate limiting

   Error: 429 Too Many Requests
   Solution: Wait before retrying or check plan limits
   

3. Invalid content

   Error: 400 Bad Request
   Solution: Verify content format and parameters
   

---

Complete API Reference

For detailed API documentation, see api-reference.md

Includes:

• All endpoints and parameters
• Request/response formats
• Authentication details
• Rate limits and best practices
• Error codes and handling

---

Tips for Best Results

Content Structure:

• Use clear headings and subheadings
• Keep bullet points concise
• Limit to 3-5 points per section
• Include relevant examples or data

Theme Selection:

• Theme ID is required for standard generation
• Search with keywords matching presentation purpose
• Common searches: "business", "professional", "creative", "education", "modern"
• Each theme has unique styling and layout

Reference Images:

• Use high-quality images for best results
• Can use URL or base64 encoded image
• Public URL must be accessible
• Consider resolution setting (1K/2K/4K) based on quality needs
• Use page=0 for automatic slide count detection

Document Processing:

• Extract only key information
• Don't try to fit entire document in slides
• Focus on main insights and takeaways
• Ask user which sections to emphasize

2slides Skills for Claude Code

AI-powered presentation generation using the 2slides API. This Claude Code skill enables you to create professional presentations from text content, match reference image styles, or summarize documents into slides.

Important Links

🌐 2slides Website - Learn about 2slides features, pricing, and create presentations online

🔑 Get API Access - Sign up for API access, get your API key, and view API documentation

📚 API Documentation - Complete API reference with endpoints, parameters, and examples

New to 2slides? Start at 2slides.com to explore features, then visit 2slides.com/api to get your API key and enable this skill.

Overview

This skill provides integrated access to 2slides presentation generation capabilities within Claude Code. Generate slides in multiple languages, choose from various themes, and create presentations using several different methods.

Features

• Content-Based Generation: Create slides from text, outlines, or bullet points
• Reference Image Matching: Generate slides that match the style of an existing image
• Document Summarization: Convert documents (PDF, DOCX, TXT) into presentation format
• Theme Search: Browse and select from professional themes
• Multi-Language Support: Generate presentations in 18+ languages
• Sync & Async Modes: Choose immediate results or batch processing
• MCP Integration: Use native tools in Claude Desktop

Before You Begin

This skill requires a 2slides API account and API key. Follow these steps:

Step 1: Explore 2slides

Visit 2slides.com to:

• See examples of AI-generated presentations
• Understand available features and capabilities
• Review pricing plans and credit system
• Try the web interface to see what's possible

Step 2: Get API Access

Visit 2slides.com/api to:

• Sign up for an API account
• Generate your API key
• View API documentation and usage limits
• Check your credit balance and usage
• Access API endpoints reference

Once you have your API key, proceed with installation below.

Installation

1. Set Up API Key

First time using 2slides?

1. Visit 2slides.com to learn about the platform and features
2. Go to 2slides.com/api to access the API portal
3. Create an account if you don't have one
4. Generate your API key from the API dashboard
5. Set the environment variable with your API key:

export SLIDES_2SLIDES_API_KEY="your_api_key_here"

To make this permanent, add it to your shell configuration file (~/.bashrc, ~/.zshrc, etc.):

echo 'export SLIDES_2SLIDES_API_KEY="your_api_key_here"' >> ~/.zshrc
source ~/.zshrc

2. Install the Skill

Copy this skill directory to your Claude Code skills location or invoke it directly using the skill name when it's available in your environment.

3. (Optional) Configure MCP Server

For Claude Desktop integration, add the 2slides MCP server to your Claude configuration. See references/mcp-integration.md for complete setup instructions.

Quick Start

Create Slides from Text

Create a presentation about machine learning with these sections:
- Introduction to ML
- Types of Learning
- Applications
- Future Trends

Create Slides from a Document

Create slides from this research paper [attach PDF]

Match a Reference Style

Create slides about our Q4 results matching the style of this image: https://example.com/template.jpg

Search for Themes

Search for professional business themes

Usage Examples

Example 1: Quick Presentation

User: Create a 5-slide presentation about climate change

Claude: [Searches for appropriate theme]
        [Generates structured content]
        [Creates presentation with generate_slides.py]

        Your presentation is ready!
        View online: https://2slides.com/slides/abc123
        Download PDF: https://2slides.com/slides/abc123/download

Example 2: Document Summary

User: [Uploads 20-page research paper]
      Summarize this into slides

Claude: [Reads document]
        [Extracts key points]
        [Structures content for slides]
        [Generates presentation]

        Created a 12-slide summary of your research paper.

Example 3: Style Matching

User: Create slides about our product launch using this design
      [provides reference image URL]

Claude: [Generates slides matching the reference style]

        Slides created matching your design template.

Command Reference

The skill includes three Python scripts for API interaction:

Generate Slides

# Basic generation with theme
python scripts/generate_slides.py --content "Your content" --theme-id "theme123"

# With language
python scripts/generate_slides.py --content "Content" --theme-id "theme123" --language "Spanish"

# From reference image
python scripts/generate_slides.py --content "Content" --reference-image "https://example.com/img.jpg"

# Async mode
python scripts/generate_slides.py --content "Content" --theme-id "theme123" --mode async

Search Themes

# Search for themes
python scripts/search_themes.py --query "business"
python scripts/search_themes.py --query "creative" --limit 50

Check Job Status

# For async jobs
python scripts/get_job_status.py --job-id "job123"

Documentation

• SKILL.md: Complete skill documentation with workflows and examples
• api-reference.md: Detailed API documentation
• mcp-integration.md: MCP server setup and configuration

Supported Languages

Auto, English, Simplified Chinese, Traditional Chinese, Spanish, French, German, Japanese, Korean, Arabic, Portuguese, Indonesian, Russian, Hindi, Vietnamese, Turkish, Polish, Italian, and more.

Generation Modes

Content-Based Generation

Generate slides from text content using pre-designed themes.

Requirements:

• Text content (can be structured or unstructured)
• Theme ID (search themes first)

Best for:

• Quick presentations
• Structured outlines
• Bullet-point content

Reference Image Generation

Create slides matching the style of a reference image.

Requirements:

• Text content
• Reference image URL (public or base64)

Best for:

• Matching existing brand guidelines
• Replicating design templates
• Consistent visual style

Credit costs:

• 1K/2K resolution: 100 credits per page
• 4K resolution: 200 credits per page

Document Summarization

Convert documents into presentation format.

Supported formats:

• PDF documents
• Microsoft Word (DOCX)
• Plain text (TXT, MD)

Best for:

• Research papers
• Reports
• Long-form content

Tips for Best Results

1. Structure Your Content

   • Use clear headings and subheadings
   • Keep bullet points concise (3-5 per slide)
   • Include relevant examples or data

2. Choose Appropriate Themes

   • Search with keywords matching your purpose
   • Common searches: "business", "professional", "creative", "education"
   • Preview themes before selecting

3. Reference Images

   • Use high-quality images for better matching
   • Ensure images are publicly accessible
   • Consider resolution settings based on quality needs

4. Document Processing

   • Focus on key insights, not full text
   • Use document headings as slide titles
   • Ask user which sections to emphasize

Troubleshooting

API Key Issues

Error: API key not found
Solution: Set SLIDES_2SLIDES_API_KEY environment variable

To get your API key:

• Go to 2slides.com/api
• Log in to your account
• Navigate to API Keys section
• Generate a new key if needed

Rate Limiting

Error: 429 Too Many Requests
Solution: Wait before retrying or check your plan limits

To check your usage and limits:

• Visit 2slides.com/api
• Check your current plan and credit balance
• Review API rate limits for your tier
• Consider upgrading your plan at 2slides.com

Invalid Content

Error: 400 Bad Request
Solution: Verify content format and required parameters (theme-id or reference-image)

For API support:

• Visit 2slides.com/api for API documentation
• Check the API reference for correct parameter formats
• Contact 2slides support through 2slides.com

Advanced Configuration

Async vs Sync Mode

Sync Mode (default):

• Waits for generation (30-60 seconds)
• Returns results immediately
• Best for interactive use

Async Mode:

• Returns job ID immediately
• Poll for results with get_job_status.py
• Best for batch processing or large presentations

Custom Settings

You can customize generation with additional parameters:

--aspect-ratio "16:9"          # Slide dimensions
--resolution "2K"              # Output quality (1K, 2K, 4K)
--page 10                      # Number of slides
--content-detail "concise"     # Brief or detailed content

See SKILL.md for complete parameter documentation.

Contributing

This skill is designed to work with the official 2slides API. For API issues or feature requests, contact 2slides support at https://2slides.com.

For skill-related improvements, ensure all changes maintain compatibility with the 2slides API specification.

License

This skill integrates with the 2slides API service. Usage is subject to 2slides terms of service and API usage limits.

Resources

2slides Platform

• 2slides.com - Main website
  • Product features and demos
  • Pricing and plans
  • Web-based presentation creation
  • Account management
  • Support and contact information

API & Development

• 2slides.com/api - API Portal
  • Get your API key
  • API documentation and reference
  • Usage limits and credit information
  • Code examples and guides
  • API status and updates

Claude Code

• Claude Code - Official Claude Code documentation
• Skill Documentation - See SKILL.md for complete usage guide

Getting Help

• API Issues: Visit 2slides.com/api for documentation
• Account Questions: Contact support through 2slides.com
• Skill Usage: Refer to SKILL.md and api-reference.md

Version

Current version: 1.0.0

---

Made with Claude Code