AI-powered presentation generation via the 2slides API — create slides from text, match a reference image style, summarize documents into decks, add AI voice narration, and export pages/audio. Use for any "make slides", "create a deck", or "slides from this document" request.
Instrucciones de origen · Vista previa de solo lectura
name
2slides-ppt-generator
description
AI-powered presentation generation via the 2slides API — create slides from text, match a reference image style, summarize documents into decks, add AI voice narration, and export pages/audio. Use for any "make slides", "create a deck", or "slides from this document" request.
{"setup":{"type":"manual","summary":"Install Python requirements and configure a 2slides API key before running generation scripts.","docs":"SKILL.md"}}
2slides Presentation Generation
Overview
Generate professional presentations using the 2slides AI API. The skill supports content-based generation (theme-driven Fast PPT), style matching from a reference image, custom PDF design, document summarization, AI voice narration, and exporting pages/audio. It returns both an interactive slide URL and a downloadable PDF.
This skill is adapted from the official 2slides skill repository (2slides/slides-generation-2slides-skills). It calls the hosted 2slides API and requires the user's own API key and credits.
When to Use This Skill
Use when the user asks to "create a presentation", "make slides", or "generate a deck" from text or an outline.
Use when the user wants slides that match the style of a reference image ("create slides like this image").
Use when the user wants custom-designed PDF slides without a reference image.
Use when the user uploads a document and asks to "create slides from this document".
Use when the user wants to add AI voice narration to generated slides, or export slides as PNG images and narration as WAV audio.
Use when the user asks "what themes are available?" or wants to browse/select a theme.
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 custom designed slides" or "Create PDF slides"
│ └─> Use Custom PDF Generation (Section 3)
│
├─ "Create slides from this document"
│ └─> Use Document Summarization (Section 4)
│
├─ "Add voice narration" or "Generate audio for slides"
│ └─> Use Voice Narration (Section 5)
│
├─ "Download slides as images" or "Export slides and voices"
│ └─> Use Download Export (Section 6)
│
└─ "Search for themes" or "What themes are available?"
└─> Use Theme Search (Section 7)
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):
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. Custom PDF Generation
Generate custom-designed slides from text without needing a reference image.
When to Use
User wants custom design without providing a reference image
User requests "create PDF slides"
User wants to specify design characteristics
Alternative to theme-based generation with more design flexibility
Workflow
Step 1: Prepare Content
Structure the content clearly:
Title: [Main Topic]
Section 1: [Subtopic]
- Key point 1
- Key point 2
Section 2: [Subtopic]
- Key point 1
- Key point 2
Step 2: Generate Slides
Use the create_pdf_slides.py script:
# Basic generation
python scripts/create_pdf_slides.py --content "Your content here"# With design style (API: designStyle)
python scripts/create_pdf_slides.py \
--content "Sales Report Q4 2025" \
--design-style "modern minimalist, blue color scheme"# High resolution with auto page detection
python scripts/create_pdf_slides.py \
--content "Marketing Plan" \
--resolution 4K \
--page 0 \
--content-detail standard
Optional parameters:
--design-style "text"# Design instructions (API: designStyle)
--language LANG # Same as generate_slides (default: Auto)
--aspect-ratio RATIO # 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9 (default: 16:9)
--resolution 1K|2K|4K # default: 2K
--page N # 0=auto, 1-100 (default: 1)
--content-detail concise|standard # default: standard
Step 3: Handle Results
Returns same structure as create-like-this:
{"slideUrl":"https://2slides.com/workspace?jobId=...","pdfUrl":"https://...pdf...","status":"completed","message":"Successfully generated N slides","slidePageCount": N
}
Notes:
Same credit costs as create-like-this (100 credits/page for 1K/2K, 200 for 4K)
Processing time: ~30 seconds per page
Automatically generates PDF
Uses AI to create custom design based on content and specs
4. 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
5. Voice Narration
Add AI-generated voice narration to slides.
When to Use
User wants to add audio to slides
User requests "add voice narration" or "generate audio"
User wants presentations with spoken content
User needs multi-speaker narration
Prerequisites
IMPORTANT: The slide generation job must be completed before adding narration.
Generate slides first using any method (Section 1, 2, 3, or 4)
Get the job ID from the generation result
Ensure job status is "completed" before requesting narration
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
Security & Safety Notes
Credentials: This skill reads the API key from the SLIDES_2SLIDES_API_KEY enprojectnment variable. Never hard-code the key in commands, commit it, or echo it back to the user. The scripts send it as a bearer/apikey value to https://2slides.com over HTTPS only.
Network + paid mutations: Every generation call makes an outbound network request to the 2slides API and spends the user's credits (10–210 credits/page depending on mode). Treat generation, reference-image, custom-PDF, and narration calls as billable actions — confirm intent before generating large or high-resolution (4K) decks, and surface the expected page count/cost when it is non-trivial.
No destructive local actions: The scripts only read content/files the user points to and write generated output (e.g. a downloaded ZIP) to the path the user specifies. They do not modify or delete unrelated files.
Input handling: Reference-image and document inputs are sent to the 2slides service for processing. Do not submit confidential material the user has not authorized for third-party processing.
Download URLs expire in 1 hour — fetch artifacts promptly and do not treat the URLs as durable storage.
Limitations
Requires a valid 2slides account, API key, and sufficient credits; this skill does not provision or pay for credits.
Results are AI-generated drafts intended as a starting point, not a final, fact-checked deliverable — review content before use.
This skill does not replace enprojectnment-specific validation or expert review. Stop and ask for clarification if the API key, required inputs, or intended cost/scope are missing.
Rate limits apply (Fast PPT 10/min, Nano Banana 6/min); poll async jobs every 20–30s rather than tight-looping.
Related Skills
@youtube-full — fetch source material (transcripts) that can be summarized into a deck with this skill.
