2slides-ppt-generator
starsforks
How to install 2slides-ppt-generator?
sickn33/agentic-awesome-skills/2slides-ppt-generator
$npx -y skills add sickn33/agentic-awesome-skills --skill 2slides-ppt-generatorAI-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\" reques
SKILL.md
| 1 | # 2slides Presentation Generation |
| 2 | |
| 3 | ## Overview |
| 4 | |
| 5 | 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. |
| 6 | |
| 7 | This skill is adapted from the official 2slides skill repository ([`2slides/slides-generation-2slides-skills`](https://github.com/2slides/slides-generation-2slides-skills)). It calls the hosted 2slides API and requires the user's own API key and credits. |
| 8 | |
| 9 | ## When to Use This Skill |
| 10 | |
| 11 | - Use when the user asks to "create a presentation", "make slides", or "generate a deck" from text or an outline. |
| 12 | - Use when the user wants slides that match the style of a reference image ("create slides like this image"). |
| 13 | - Use when the user wants custom-designed PDF slides without a reference image. |
| 14 | - Use when the user uploads a document and asks to "create slides from this document". |
| 15 | - Use when the user wants to add AI voice narration to generated slides, or export slides as PNG images and narration as WAV audio. |
| 16 | - Use when the user asks "what themes are available?" or wants to browse/select a theme. |
| 17 | |
| 18 | ## Setup Requirements |
| 19 | |
| 20 | Users must have a 2slides API key and credits: |
| 21 | |
| 22 | 1. **Get API Key:** Visit https://2slides.com/api to create an account and API key |
| 23 | - New users receive **500 free credits** (~50 Fast PPT pages) |
| 24 | 2. **Purchase Credits (Optional):** Visit https://2slides.com/pricing to buy additional credits |
| 25 | - Pay-as-you-go, no subscriptions |
| 26 | - Credits never expire |
| 27 | - Up to 20% off on larger packages |
| 28 | 3. **Set API Key:** Store the key in environment variable: `SLIDES_2SLIDES_API_KEY` |
| 29 | |
| 30 | ```bash |
| 31 | read -r -s SLIDES_2SLIDES_API_KEY |
| 32 | export SLIDES_2SLIDES_API_KEY |
| 33 | ``` |
| 34 | |
| 35 | 4. **Install Script Dependencies:** From this skill directory, install the pinned local requirements before using the Python scripts: |
| 36 | |
| 37 | ```bash |
| 38 | python -m pip install -r requirements.txt |
| 39 | ``` |
| 40 | |
| 41 | **Credit Costs:** |
| 42 | - Fast PPT: 10 credits/page |
| 43 | - Nano Banana 1K/2K: 100 credits/page |
| 44 | - Nano Banana 4K: 200 credits/page |
| 45 | - Voice Narration: 210 credits/page |
| 46 | - Download Export: FREE |
| 47 | |
| 48 | See [references/pricing.md](references/pricing.md) for detailed pricing information. |
| 49 | |
| 50 | ## Workflow Decision Tree |
| 51 | |
| 52 | Choose the appropriate approach based on the user's request: |
| 53 | |
| 54 | ``` |
| 55 | User Request |
| 56 | │ |
| 57 | ├─ "Create slides from this content/text" |
| 58 | │ └─> Use Content-Based Generation (Section 1) |
| 59 | │ |
| 60 | ├─ "Create slides like this image" |
| 61 | │ └─> Use Reference Image Generation (Section 2) |
| 62 | │ |
| 63 | ├─ "Create custom designed slides" or "Create PDF slides" |
| 64 | │ └─> Use Custom PDF Generation (Section 3) |
| 65 | │ |
| 66 | ├─ "Create slides from this document" |
| 67 | │ └─> Use Document Summarization (Section 4) |
| 68 | │ |
| 69 | ├─ "Add voice narration" or "Generate audio for slides" |
| 70 | │ └─> Use Voice Narration (Section 5) |
| 71 | │ |
| 72 | ├─ "Download slides as images" or "Export slides and voices" |
| 73 | │ └─> Use Download Export (Section 6) |
| 74 | │ |
| 75 | └─ "Search for themes" or "What themes are available?" |
| 76 | └─> Use Theme Search (Section 7) |
| 77 | ``` |
| 78 | |
| 79 | --- |
| 80 | |
| 81 | ## 1. Content-Based Generation |
| 82 | |
| 83 | Generate slides from user-provided text content. |
| 84 | |
| 85 | ### When to Use |
| 86 | - User provides content directly in their message |
| 87 | - User says "create a presentation about X" |
| 88 | - User provides structured outline or bullet points |
| 89 | |
| 90 | ### Workflow |
| 91 | |
| 92 | **Step 1: Prepare Content** |
| 93 | |
| 94 | Structure the content clearly for best results: |
| 95 | |
| 96 | ``` |
| 97 | Title: [Main Topic] |
| 98 | |
| 99 | Section 1: [Subtopic] |
| 100 | - Key point 1 |
| 101 | - Key point 2 |
| 102 | - Key point 3 |
| 103 | |
| 104 | Section 2: [Subtopic] |
| 105 | - Key point 1 |
| 106 | - Key point 2 |
| 107 | ``` |
| 108 | |
| 109 | **Step 2: Choose Theme (Required)** |
| 110 | |
| 111 | Search for an appropriate theme (themeId is required): |
| 112 | |
| 113 | ```bash |
| 114 | python scripts/search_themes.py --query "business" |
| 115 | python scripts/search_themes.py --query "professional" |
| 116 | python scripts/search_themes.py --query "creative" |
| 117 | ``` |
| 118 | |
| 119 | Pick a theme ID from the results. |
| 120 | |
| 121 | **Step 3: Generate Slides** |
| 122 | |
| 123 | Use the `generate_slides.py` script with the theme ID: |
| 124 | |
| 125 | ```bash |
| 126 | # Basic generation (theme ID required) |
| 127 | python scripts/generate_slides.py --content "Your content here" --theme-id "theme123" |
| 128 | |
| 129 | # In different language |
| 130 | python scripts/generate_slides.py --content "Your content" --theme-id |
People who liked this also viewed
6 picksType
- seo-auditWhen the user wants to audit, review, or diagnose SEO issues on their site. Also use when the user mentions "SEO audit," "technical SEO," "why am I not ranking," "SEO issues," "on-page SEO," "meta tagSkillsJul 2026
- copywritingWhen the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages, pricing pages, feature pages, about pages, or product pages. Also use when the user sSkillsJul 2026
- marketing-psychologyWhen the user wants to apply psychological principles, mental models, or behavioral science to marketing. Also use when the user mentions 'psychology,' 'mental models,' 'cognitive bias,' 'persuasion,'SkillsJul 2026
- content-strategyWhen the user wants to plan a content strategy, decide what content to create, or figure out what topics to cover. Also use when the user mentions "content strategy," "what should I write about," "conSkillsJul 2026
- programmatic-seoWhen the user wants to create SEO-driven pages at scale using templates and data. Also use when the user mentions "programmatic SEO," "template pages," "pages at scale," "directory pages," "location pSkillsJul 2026
- marketing-ideasWhen the user needs marketing ideas, inspiration, or strategies for their SaaS or software product. Also use when the user asks for 'marketing ideas,' 'growth ideas,' 'how to market,' 'marketing stratSkillsJul 2026
