kayforkind/skill-slice/2slides-ppt-generator

Claude Code and agent skill by kayforkind/skill-slice

Trust tier 2
  • community
LLM review pending
Source check pending

Checking that the SKILL.md file is still in the repository.

Calls the 2slides hosted API for Fast PPT, image-matched Nano Banana decks, document-to-slides, AI voiceover, and PNG/WAV zip export. Use when the user wants 2slides themes, create-like-this, or billed narration. Not for local PowerPoint COM/Open XML authoring or Remotion frame videos.

Install

npx vskill@latest install kayforkind/skill-slice/2slides-ppt-generator

SKILL.md

The same SKILL.md was published earlier as kayforkind/skill-slice/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

  • User asks to "create a presentation", "make slides", or "generate a deck" from text or an outline.
  • User wants slides that match the style of a reference image ("create slides like this image").
  • User wants custom-designed PDF slides without a reference image.
  • User uploads a document and asks to "create slides from this document".
  • User wants to add AI voice narration to generated slides, or export slides as PNG images and narration as WAV audio.
  • User asks "what themes are available?" or wants to browse/select a theme.

Prerequisites

Users must have a 2slides API key and credits before running any generation script.

  1. 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).
  1. Purchase Credits (Optional): Visit https://2slides.com/pricing.
  • Pay-as-you-go, no subscriptions.
  • Credits never expire.
  • Up to 20% off on larger packages.
  1. Set API Key: Store the key in environment variable SLIDES_2SLIDES_API_KEY.

Windows (PowerShell, primary host): ``powershell $env:SLIDES_2SLIDES_API_KEY = "YOUR_KEY" # To persist for the user session: [System.Environment]::SetEnvironmentVariable("SLIDES_2SLIDES_API_KEY", "YOUR_KEY", "User") ``

Linux/macOS: ``bash read -r -s SLIDES_2SLIDES_API_KEY export SLIDES_2SLIDES_API_KEY ``

  1. Install Script Dependencies: From this skill directory, install the pinned local requirements before using the Python scripts:

``powershell python -m pip install -r requirements.txt ``

Credit Costs (per page):

ModeCredits/page
Fast PPT (generate)10
Nano Banana 1K/2K (create-like-this, create-pdf-slides)100
Nano Banana 4K200
Voice Narration210 (10 text + 200 audio)
Download ExportFREE

Load references/pricing.md when the user asks about credit packages, cost calculations, free trial details, refund policy, or enterprise options.

Procedure

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

User Request
│
├─ "Create slides from this content/text" → Section 1 (Content-Based Generation)
├─ "Create slides like this image" → Section 2 (Reference Image Generation)
├─ "Create custom designed slides" / "PDF slides"→ Section 3 (Custom PDF Generation)
├─ "Create slides from this document" → Section 4 (Document Summarization)
├─ "Add voice narration" / "Generate audio" → Section 5 (Voice Narration)
├─ "Download slides as images" / "Export" → Section 6 (Download Export)
└─ "Search for themes" / "What themes available?"→ Section 7 (Theme Search)

1. Content-Based Generation

Generate slides from user-provided text content using a theme (Fast PPT).

When to use: User provides content directly, says "create a presentation about X", or provides a structured outline/bullet points.

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 — themeId is mandatory)

Search for an appropriate theme:

powershell
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

powershell
# 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:

json
{
"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:

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

Poll for results (every 20–30 seconds to avoid server strain):

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

2. Reference Image Generation

Generate slides that match the style of a reference image (Nano Banana Pro mode).

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 to emulate.

Step 1: Verify Image URL

Ensure the reference image is:

  • A publicly accessible URL.
  • A valid image format (PNG, JPG, etc.).
  • Representative of the desired slide style.

Step 2: Generate Slides

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

Optional parameters (all values from [2slides API](https://2slides.com/api.md)):

--language LANG # Auto, English, Spanish, Arabic, Portuguese, Indonesian,
# Japanese, Russian, Hindi, French, German, Greek, Vietnamese,
# Turkish, Polish, Italian, Korean, Simplified Chinese,
# Traditional Chinese, Thai (default: Auto)
--mode sync|async # default: sync for theme, async for reference-image
--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: concise

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:

json
{
"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.

Step 1: Prepare Content

Structure the content clearly (same format as Section 1, Step 1).

Step 2: Generate Slides

powershell
# 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 (Section 2, Step 3).

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.

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:

powershell
# 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 — HARD RULE: The slide generation job must be completed before adding narration.

  1. Generate slides first using any method (Section 1, 2, 3, or 4).
  2. Get the job ID from the generation result.
  3. Ensure job status is "completed" before requesting narration.

Step 1: Choose Voice

30 voices available including Puck (default), Aoede, Charon, Kore, Fenrir, Phoebe, and 24 more.

List all voices:

powershell
python scripts/generate_narration.py --list-voices

Step 2: Generate Narration

powershell
# Basic narration with default voice
python scripts/generate_narration.py --job-id "abc-123-def-456"
# Single speaker, specific voice
python scripts/generate_narration.py --job-id "abc-123-def-456" --voice Aoede
# Multi-speaker mode
python scripts/generate_narration.py --job-id "abc-123-def-456" --multi-speaker

Parameters (aligned with [2slides API](https://2slides.com/api.md)):

  • --job-id: Job ID (required, UUID for Nano Banana).
  • --voice: Voice name (default: Puck); use --list-voices for all 30.
  • --language: Narration language (default: Auto).
  • --multi-speaker: Enable multi-speaker mode.
  • --list-voices: Print the supported voices without calling the API.

Step 3: Check Status

This is the start of the file. Read the full SKILL.md on GitHub.

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewNot runA model review is scheduled for the next rescan.

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

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
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/kayforkind/skill-slice/2slides-ppt-generator/badge)](https://verified-skill.com/skills/kayforkind/skill-slice/2slides-ppt-generator)

Something wrong with this skill or its page? Tell us.