# Tiktok Instagram Slideshow

> Generate vertical 9:16 and portrait 4:5 photo slideshows for TikTok Photo Mode, Instagram Carousels, Instagram Stories, Instagram Reels slide sequences, and paid social ads via MCP, with real photos, app screenshots, brand logos, and bold brand-world poster scenes on every slide. Use when the user asks for a TikTok slideshow, TikTok photo mode post, IG carousel, IG story sequence, or viral UGC/ad slideshow.

- Skill: `illyism/tiktok-instagram-slideshow` (Agent Skill)
- Install (CLI): `npx get-skill add illyism/tiktok-instagram-slideshow`
- Raw SKILL.md: https://api.skillmd.com/api/skills/illyism/tiktok-instagram-slideshow/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Design & Media
- Author: Illyism (https://skillmd.com/u/illyism)
- Updated: 2026-11-15
- Page: https://skillmd.com/skills/illyism/tiktok-instagram-slideshow

---


# TikTok Photo Mode & Instagram Slideshow Generator

## The One Rule: Every Slide Is a Picture First

**Never ship a slide that is only words, bullets, or a colored bar on a plain background.** *Why*: TikTok and Instagram are photo feeds; a text-on-dark-canvas card reads as a lazy AI quote post and gets swiped in under a second. The image carries the slide; the words caption it.

Walk this tree for each slide:

```
What is this slide about?
├── An app, site, product page, or tool with a public URL
│   → screenshotUrl = that URL. visual: the live page inside a phone mockup held in-hand
│     or floating at an angle, with 1 bold sticker-style callout on the key element.
├── A named brand, app, or product (Spotify, Coca-Cola, Apple, Shopify, Notion...)
│   → visual names its logo/wordmark, app icon, and brand palette explicitly, on a
│     saturated backdrop in that brand's color. imageUrl = a public logo or product image when you have one.
├── A real person (founder, executive, public figure, historical portrait)
│   → imageUrl = their Wikimedia Commons or press-room portrait, on this slide only.
├── A lifestyle, emotion, or relatable-pain beat
│   → imageUrl of a real photo, else unsplashQuery (concrete real place or scene, ≤120 chars:
│     "tired founder laptop 2am kitchen" not "productivity"). Historical scene, object
│     metaphor, or 3D product render → no unsplashQuery; describe the object in visual.
├── A before/after or comparison
│   → split scene: two real photos or two screenshots side by side, labeled.
└── A number or result
    → the number huge over a photorealistic studio-lit hero object or the product itself,
      never a number alone on a flat background.
```

## Step 1. Pick Aspect Ratio & Safe Zone by Surface

```
Which surface is this slideshow targeting?
├── TikTok Photo Mode / Instagram Stories / Reels Slide Sequence
│   ├── Aspect ratio → 9:16 (1080×1920)
│   ├── Slide count → 5–9 slides (default 6)
│   └── Mandatory UI Safe Zone:
│       • Top 15% clear (FYP tabs / Story progress bars)
│       • Right 20% clear on TikTok & Reels (avatar, like, comment, save, share stack)
│       • Bottom 28% clear (handle, caption, audio ticker, Story reply bar)
│       • Place all text, logos, and screenshots inside x 0–80%, y 15–72%.
│         Full-bleed photos and backdrops may run edge to edge behind the UI.
└── Instagram Feed Carousel (or Meta 4:5 Carousel Ad)
    ├── Aspect ratio → 4:5 (1080×1350)
    ├── Slide count → 6–10 slides (up to 10 via Graph API; up to 20 manual)
    └── Safe Zone → 48px all-around margin; top-right clear of "1/10" pill
```

## Step 2. Sequence the Swipe Loop

- **Slide 1 (0.8-Second Scroll Stop):** max **7 words** over the most striking image in the deck—a brand-world poster, a real photo, or the product in-hand. Open an unresolved curiosity loop or stark contrast (`"3 pricing mistakes killing your trial conversions"`). Never open with a plain logo lockup or welcome screen.
- **Slide 2 (Ground the Stakes):** 1 proof point (`<= 18 words`) shown as a real screenshot, receipt, or photo confirming Slide 1 wasn't clickbait.
- **Slides 3 to N−1 (One Reveal Per Swipe):** exactly **1 idea per slide**, numbered (`01`, `02`, `03`), **under 20 words**, each with its own image. *Why*: thumb-swipers spend ~2 seconds per frame and abandon dense paragraphs.
- **Slide N (Save / Share Payoff):** a checklist or tool list with each tool's app icon next to its row (`"Save this before your next launch"`). *Why*: saves bring the post back to the saver and count toward reach.

## Step 3. Gather Visual Assets (Mandatory Before Rendering)

*Why*: the renderer can only show what you hand it; a slideshow planned without images comes back as text cards.

1. **List every brand, app, product, and scene** in the slideshow.
2. **Find a public URL for each product or app**: homepage, App Store page, pricing page, product page. Open it to confirm it loads without a login or cookie wall.
3. **Assign assets:**
   - `websiteUrls` (deck-level, max 6): the key product pages; GenPPT captures live browser screenshots of them.
   - `slides[].screenshotUrl`: the exact page that slide shows.
   - `slides[].imageUrl`: a direct public image URL (product photo, logo, press image) you have actually seen. **Never guess or construct an image URL.** *Why*: a dead URL renders as an empty frame. If you have no URL, name the logo or product in `visual`.
   - **Real people: `slides[].imageUrl` only.** For a founder, executive, public figure, or historical portrait, pass a real Wikimedia Commons (`https://upload.wikimedia.org/...`) or official press-room portrait URL on that one slide. Never ask for a real person's face from text alone. *Why*: given a real portrait, GenPPT renders a close photographic likeness with no safety refusals; the likeness comes from the image, not the name.
   - `slides[].unsplashQuery`: **only** for real places, architecture, landscapes, cityscapes, or generic physical environments (`"kanazawa higashi chaya wooden street"`, `"hyperscale server room aisle"`). Omit it on historical scenes, object inventions or metaphors, 3D book or product renders, and data diagrams. *Why*: stock search returns literal modern mismatches (formal leather dress shoes for a 1971 waffle-sole track flat); with no stock photo, GenPPT illustrates the metaphor, 3D book, or chart natively.
   - `referenceImageUrls` (max 20): deck-wide brand logos and marks only. Never put a person's portrait or a slide-specific screenshot here. *Why*: deck-level references reach every slide, so one slide's face bleeds onto its neighbors.
4. **Asset ledger check:** every slide has a `screenshotUrl`, `imageUrl`, or `unsplashQuery`, or its `visual` names a specific logo, product, or object. Rewrite any slide that has none.

## Step 4. Write Concrete `visual` Prompts and `artDirection`

**`visual` formula** (every slide): `[backdrop world] + [hero image and where it sits] + [logo/icon placement] + [sticker callout] + [headline position inside the safe zone]`.

> *"Saturated Spotify-green backdrop: hand holding an iPhone showing the live Spotify Wrapped page at center, Spotify logo top-left, yellow sticker callout 'Top 0.5%' on the stats card, headline in the upper third inside x 0–80%."*

**Banned `visual` values**: `"stat card"`, `"text slide"`, `"bullet list"`, `"icon grid"`, `"clean layout"`, `"minimal card"`. *Why*: vague labels give the renderer nothing to draw except text on a box.

**`artDirection`:**
- **Match the subject's world, never default to black.** Brand story → `@TheXEffect_`-style bold brand-world posters: the brand's saturated color as backdrop (crimson red, neon green, cobalt blue), a photorealistic studio-lit hero object, the logo interacting with the scene as a visual pun. Lifestyle/UGC → real photos with a consistent warm or high-flash film look. Use one visual system across all slides (same type, same sticker style, same header tag).
- **Safe zone:** for `9:16`, write into `artDirection`: *"Keep the top 15%, right 20%, and bottom 28% free of text, logos, and screenshots so TikTok/Reels UI overlays never cover them; place them inside x 0–80%, y 15–72%. Photos may run full-bleed behind."* For `4:5`, keep a `48px` margin.
- **Type:** high-contrast bold sans-serif with highlight pills (electric lime, warm coral, crisp yellow) so text reads over photos.

**Short, clean copy:** a headline and at most one short sentence per slide. No em dashes, no AI-slop phrasing (`"isn't X, it's Y"`, `"Hits Harder"`, `"The secret is..."`), and no number repeated twice on one slide.

## Step 5. Render via MCP

1. Call `genppt_create_slideshow` (`https://genppt.com/mcp`) with `aspectRatio` (`"9:16"` or `"4:5"`), `title`, `slides` (`1..20` objects of `{ title, purpose, visual, screenshotUrl?, imageUrl?, unsplashQuery? }`), `websiteUrls`, `referenceImageUrls`, `artDirection`, and `autoRender: true`.
   - If the connected server's schema does not list `websiteUrls` or the per-slide asset fields, put every URL except portraits in `referenceImageUrls` / `attachmentUrls` and name each one in the matching slide's `visual`.
2. Call `genppt_get_deck` with `{ deckId, waitSeconds: 45 }` until `phase === "ready"`.

## Step 6. Visual QA Gate (Mandatory Before Publishing)

Open every `slideImageUrls` image and look at it. A slide fails if it:
- is text on a plain background with no photo, screenshot, logo, or object;
- is missing the screenshot, logo, or photo you planned, or has a cookie-consent or login modal covering the capture;
- shows a stock object from `unsplashQuery` that contradicts the subject, or a person's face on a slide other than their own;
- has crop bleed (a sliver of another image or frame) at a border;
- puts text, a logo, or a screenshot in the top 15%, right 20%, or bottom 28% (on `9:16`).

Fix every failing slide with `genppt_revise_slides`: `{ deckId, revisions: [{ slideNumber, instructions, screenshotUrl?, imageUrl?, placeImages? }] }`.
- Missing visual → add `screenshotUrl` or `imageUrl` plus instructions describing the scene.
- Screenshot or logo redrawn wrong, or outside the safe zone → `placeImages: [{ screenshotUrl or url, x, y, width, height }]` with `0..1` coordinates inside the safe zone (e.g. `{ x: 0.06, y: 0.28, width: 0.68, height: 0.42 }` on `9:16`). *Why*: `placeImages` pastes the real capture untouched at an exact position.
- Cookie-consent or login modal over a capture → swap `screenshotUrl` for a cleaner page with the same fact (docs, blog post, status page), or `placeImages` a clean capture.
- Mismatched stock object → revise with `instructions` naming the exact object to illustrate and no stock photo. *Why*: GenPPT draws historical objects and metaphors correctly once stock search is out of the way.
- A face on the wrong slide → revise that slide with instructions to remove the person; keep the portrait on its own slide's `imageUrl`.
- Crop bleed at a border → revise with instructions to keep every element inside the slide edges.

Re-check after `genppt_get_deck`. Max 2 revision rounds; if a slide still fails, cut it or tell the user which slide failed and why.

## Step 7. Caption & Publish

1. Draft platform-native caption copy:
   - **TikTok:** `<= 2` lines, with 3–4 search keywords written into the sentence (TikTok indexes caption words for search).
   - **Instagram:** first line `<= 125` chars (where Instagram cuts off before `"more"`) + concise bullet recap.
2. Publish or stage:
   - If a social publishing MCP or Meta/TikTok connector is active, stage as a draft (or publish live when autonomous posting was explicitly requested and permitted on the target account) using the ordered slide image URLs up to the connector's media limit (e.g. `10` for Instagram Graph API).
   - Otherwise, render the slide previews inline and return the ordered slide image URLs, `studioUrl`, and caption copy.

