renatoschust-dot/gamai-skills/2slides-ppt-generator
Claude Code and agent skill by renatoschust-dot/gamai-skills
- community
Checking that the SKILL.md file is still in the repository.
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.
Install
npx vskill@latest install renatoschust-dot/gamai-skills/2slides-ppt-generatorSKILL.md
The same SKILL.md was published earlier as renatoschust-dot/gamai-skills/2slides-ppt-generator.
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.
Setup Requirements
Users must have a 2slides API key and credits:
- Get API Key: Visit https://2slides.com/api to create an account and API key
- New users receive 500 free credits (~50 Fast PPT pages)
- Purchase Credits (Optional): Visit https://2slides.com/pricing to buy additional credits
- Pay-as-you-go, no subscriptions
- Credits never expire
- Up to 20% off on larger packages
- Set API Key: Store the key in environment variable:
SLIDES_2SLIDES_API_KEY
- Install Script Dependencies: From this skill directory, install the pinned local requirements before using the Python scripts:
Credit Costs:
- Fast PPT: 10 credits/page
- Nano Banana 1K/2K: 100 credits/page
- Nano Banana 4K: 200 credits/page
- Voice Narration: 210 credits/page
- Download Export: FREE
See references/pricing.md for detailed pricing information.
Workflow Decision Tree
Choose the appropriate approach based on the user's request:
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:
Step 2: Choose Theme (Required)
Search for an appropriate theme (themeId is required):
Pick a theme ID from the results.
Step 3: Generate Slides
Use the generate_slides.py script with the theme ID:
Step 4: Handle Results
Sync mode response:
Provide both URLs to the user:
slideUrl: Interactive online slidespdfUrl: Downloadable PDF version
Async mode response:
Poll for results:
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:
Optional parameters (all values from [2slides API](https://2slides.com/api.md)):
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:
Provide both URLs to the user:
slideUrl: View slides in 2slides workspacepdfUrl: 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:
Step 2: Generate Slides
Use the create_pdf_slides.py script:
Optional parameters:
Step 3: Handle Results
Returns same structure as create-like-this:
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:
Step 4: Generate Slides
Use content-based generation workflow (Section 1). First search for a theme, then generate:
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
Workflow
Step 1: Choose Voice
30 voices available including:
- Puck (default)
- Aoede
- Charon
- Kore
- Fenrir
- Phoebe
- And 24 more...
List all voices:
Step 2: Generate Narration
Use the generate_narration.py script with the job ID:
This is the start of the file. Read the full SKILL.md on GitHub.
Security
- Security scanPassed, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/2slides-ppt-generator/SKILL.md
Popularity
- 7-day trend score
- 5
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/renatoschust-dot/gamai-skills/2slides-ppt-generator)