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 with themes
Reference Image Matching: Generate slides that match the style of an existing image
Custom PDF Generation: Create custom-designed slides without reference images (NEW)
Voice Narration: Add AI voice narration with 30 voice options and multi-speaker support (NEW)
Export & Download: Download slides as PNG images and voice files as WAV (FREE) (NEW)
Document Summarization: Convert documents (PDF, DOCX, TXT) into presentation format
Theme Search: Browse and select from professional themes
Multi-Language Support: Generate presentations in 19+ 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.

Free Trial: New users receive 500 free credits (~50 Fast PPT pages) to get started.

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 (receive 500 free credits)
Generate your API key
View API documentation and usage limits
Check your credit balance and usage
Access API endpoints reference

Step 3: Purchase Credits (Optional)

Visit 2slides.com/pricing to:

Purchase additional credits (pay-as-you-go, no subscriptions)
View current promotions (up to 20% off)
Review pricing tiers
Credits never expire - buy what you need

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

Installation

1. Set Up API Key

First time using 2slides?

Visit 2slides.com to learn about the platform and features
Go to 2slides.com/api to access the API portal
Create an account if you don't have one
Generate your API key from the API dashboard
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 six 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

Create PDF Slides (NEW)

# Custom-designed slides without reference image
python scripts/create_pdf_slides.py --content "Sales Report Q4 2025"
 
# With design specifications
python scripts/create_pdf_slides.py \
  --content "Marketing Plan" \
  --design-spec "modern minimalist, blue color scheme"
 
# High resolution with auto page detection
python scripts/create_pdf_slides.py --content "Product Launch" --resolution "4K" --page 0

Generate Narration (NEW)

# List available voices (30 options)
python scripts/generate_narration.py --list-voices
 
# Add narration with default voice
python scripts/generate_narration.py --job-id "abc-123-def-456"
 
# With specific voice and multi-speaker
python scripts/generate_narration.py \
  --job-id "abc-123-def-456" \
  --voice "Aoede" \
  --multi-speaker
 
# In different language
python scripts/generate_narration.py \
  --job-id "abc-123-def-456" \
  --language "Spanish" \
  --voice "Charon"

Download Export (NEW)

# Download slides as PNG and voices as WAV (FREE)
python scripts/download_slides_pages_voices.py --job-id "abc-123-def-456"
 
# Download to specific path
python scripts/download_slides_pages_voices.py \
  --job-id "abc-123-def-456" \
  --output "my-presentation.zip"

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 (also shows narration status)
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
pricing.md: Pricing, credits, and cost calculations
mcp-integration.md: MCP server setup and configuration
CHANGELOG.md: Version history and updates

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

Credit cost: 10 credits per page

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

Custom PDF Generation (NEW)

Create custom-designed slides from text without a reference image.

Requirements:

Text content
Optional design specifications

Best for:

Custom designs without templates
AI-generated layouts
Flexible design requirements

Credit costs:

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

Voice Narration (NEW)

Add AI-generated voice narration to slides.

Requirements:

Completed slide generation job ID
Voice selection (30 options)

Best for:

Presentations with audio
Multi-speaker presentations
Accessible content

Credit cost: 210 credits per page (10 for text, 200 for audio)

Download Export (NEW)

Export slides as PNG images and voice files as WAV.

Best for:

Using slides in other tools
Extracting individual slide images
Getting audio files separately

Credit cost: FREE (no credits)

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

Structure Your Content
- Use clear headings and subheadings
- Keep bullet points concise (3-5 per slide)
- Include relevant examples or data
Choose Appropriate Themes
- Search with keywords matching your purpose
- Common searches: "business", "professional", "creative", "education"
- Preview themes before selecting
Reference Images
- Use high-quality images for better matching
- Ensure images are publicly accessible
- Consider resolution settings based on quality needs
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 20-30 seconds before retrying

Rate limits by endpoint:

Fast PPT (theme-based): 10 requests per minute
Nano Banana (image-based/custom): 6 requests per minute

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

Insufficient Credits

Error: INSUFFICIENT_CREDITS
Solution: Purchase more credits at https://2slides.com/pricing

To check your credit balance:

Visit 2slides.com/api
View your API dashboard
See current credit balance and usage history

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

Pricing & Credits

2slides uses a pay-as-you-go credit system with no monthly subscriptions.

Credit Packages

Current promotion: Up to 20% off credits

Credits	Price	Cost per 1,000	Savings	Fast PPT Pages
2,000	$5.00	$2.50	—	~200 pages
4,000	$9.50	$2.38	5%	~400 pages
10,000	$22.50	$2.25	10%	~1,000 pages
20,000	$42.50	$2.13	15%	~2,000 pages
40,000	$80.00	$2.00	20%	~4,000 pages

Purchase at: https://2slides.com/pricing

Free Trial

New users receive 500 free credits for onboarding:

~50 Fast PPT slide pages
~5 Nano Banana 2K pages
~2 Nano Banana 2K pages with narration

Credit Costs Summary

Feature	Credits per Page	Example (10 pages)
Fast PPT	10	100 credits
Nano Banana 1K/2K	100	1,000 credits
Nano Banana 4K	200	2,000 credits
Voice Narration	+210	+2,100 credits
Download Export	FREE	0 credits

Key Benefits

✅ Credits never expire - use at your own pace
✅ No subscriptions - pay only for what you use
✅ Volume discounts - up to 20% off
✅ 3-day refund window - risk-free purchase
✅ 500 free credits for new users

Example Costs

With the 40,000 credit package ($80, $2.00 per 1,000):

10-slide Fast PPT presentation: 100 credits = $0.20
10-slide Nano Banana 2K: 1,000 credits = $2.00
10-slide with 4K resolution: 2,000 credits = $4.00
10-slide with narration (2K + voice): 2,100 credits = $4.20

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.

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
Pricing & Credits: Visit 2slides.com/pricing or see pricing.md
Account Questions: Contact support through 2slides.com
Skill Usage: Refer to SKILL.md and api-reference.md

Version

Current version: 2.0.0

What's New in 2.0:

✨ Custom PDF slides generation without reference images
🎙️ AI voice narration with 30 voices and multi-speaker support
📥 Free download export for slides as PNG and voices as WAV
📊 Updated rate limits and credit costs
🔄 Enhanced job status tracking with narration support

Made with Claude Code

2slides Presentation Generation