/2slides-ppt-generator

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."
category: api-integration
risk: critical
source: community
source_repo: 2slides/slides-generation-2slides-skills
source_type: community
date_added: "2026-06-05"
author: 2slides
tags: [presentations, slides, powerpoint, ai, api-integration, pdf, narration, document-summarization]
tools: [claude, cursor, gemini, codex, antigravity]
plugin:
  setup:
    type: manual
    summary: "Install Python requirements and configure a 2slides API key before running generation scripts."
    docs: SKILL.md

2slides Presentation Generation

Detailed Guide

Read [the detailed guide](references/detailed-guide.md) before executing this skill. It retains the complete procedure and reference material. Treat its safety, prerequisites, and validation requirements as mandatory. For focused work, load the relevant sections; for end-to-end work, read the guide completely.

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.

Security & Safety Notes

• **Credentials:** This skill reads the API key from the `SLIDES_2SLIDES_API_KEY` environment 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.
• **Local outputs:** Downloads are limited to the current workspace, public HTTPS and 128 MiB; existing output files are refused. Signed download URLs are bearer capabilities: avoid logging/sharing them beyond the intended recipient. Validate ZIP entries and extraction size before unpacking.
• **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

• A request timeout may still leave a paid server job running. Check job/account state before retrying; these scripts do not provide idempotency keys or refunds. `page=0` selects an unknown page count, so set an agreed explicit budget/count before billable generation.
• API response schemas, pricing, voices, rate limits and URL expiry are version-dependent; current sources take precedence over snapshots.

• 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 environment-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.