2slides-ppt-generator – Documents & Office skill for AI agents

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.