2slides-ppt-generator

Files (13)

• SKILL.md
• api-reference.md · references/
• detailed-guide.md · references/
• mcp-integration.md · references/
• pricing.md · references/
• requirements.txt
• api_constants.py · scripts/
• create_pdf_slides.py · scripts/
• download_slides_pages_voices.py · scripts/
• generate_narration.py · scripts/
• generate_slides.py · scripts/
• get_job_status.py · scripts/
• search_themes.py · scripts/

SKILL.md (first lines)

# 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.

From sickn33/agentic-awesome-skills, MIT.

More from sickn33/agentic-awesome-skills