Skip to content

LeoYeAI/agent-master-skills / skills/2slides-skills

2slides

Unverified

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 Skills for Claude Code

AI-powered presentation generation using the [2slides API](https://2slides.com). 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](https://2slides.com)** - Learn about 2slides features, pricing, and create presentations online

**πŸ”‘ [Get API Access](https://2slides.com/api)** - Sign up for API access, get your API key, and view API documentation

**πŸ“š [API Documentation](https://2slides.com/api)** - Complete API reference with endpoints, parameters, and examples

> **New to 2slides?** Start at [2slides.com](https://2slides.com) to explore features, then visit [2slides.com/api](https://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](https://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](https://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](https://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?**

1. **Visit [2slides.com](https://2slides.com)** to learn about the platform and features
2. **Go to [2slides.com/api](https://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:

```bash
export SLIDES_2SLIDES_API_KEY="your_api_key_here"
```

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

```bash
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](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

```bash
# 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)

```bash
# 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)

```bash
# 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)

```bash
# 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

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

### Check Job Status

```bash
# For async jobs (also shows narration status)
python scripts/get_job_status.py --job-id "job123"
```

## Documentation

- **[SKILL.md](SKILL.md)**: Complete skill documentation with workflows and examples
- **[api-reference.md](references/api-reference.md)**: Detailed API documentation
- **[pricing.md](references/pricing.md)**: Pricing, credits, and cost calculations
- **[mcp-integration.md](references/mcp-integration.md)**: MCP server setup and configuration
- **[CHANGELOG.md](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

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](https://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](https://2slides.com/api)
- Check your current plan and credit balance
- Review API rate limits for your tier
- Consider upgrading your plan at [2slides.com](https://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](https://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](https://2slides.com/api) for API documentation
- Check the API reference for correct parameter formats
- Contact 2slides support through [2slides.com](https://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:

```bash
--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](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](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](https://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](https://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](https://claude.ai/claude-code)** - Official Claude Code documentation
- **Skill Documentation** - See [SKILL.md](SKILL.md) for complete usage guide

### Getting Help
- **API Issues**: Visit [2slides.com/api](https://2slides.com/api) for documentation
- **Pricing & Credits**: Visit [2slides.com/pricing](https://2slides.com/pricing) or see [pricing.md](references/pricing.md)
- **Account Questions**: Contact support through [2slides.com](https://2slides.com)
- **Skill Usage**: Refer to [SKILL.md](SKILL.md) and [api-reference.md](references/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
canvas-designanthropics/skillsCreate beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
docxanthropics/skillsUse this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
pdfanthropics/skillsUse this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
pptxanthropics/skillsUse this skill any time a .pptx or .potx file is involved in any way β€” as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill.Stars: 198kUpdated Claude CodeCodexVerifiedInstall