X (Twitter) Portrait Slideshow & 20-Image Carousel Generator
The One Rule: Every Slide Shows Concrete Visual Evidence
Never ship a slide that is only words, bullets, or a colored bar on a plain background. Why: X users scroll straight past text-on-dark-canvas posters because they read as lazy AI quote cards. A real screenshot, logo, product, or photo is what stops the thumb and proves the claim.
Every slide gets at least one of these. Walk this tree for each slide:
What is this slide about?
├── A product, site, repo, pricing page, status page, doc, or source article with a public URL
│ → screenshotUrl = that URL. visual: the live page framed in a browser / OS / phone window,
│ with 1–2 callout badges pointing at the exact element that proves the slide's claim.
├── A named company, model, app, or tool (Stripe, OpenAI, Claude, Shopify, Spotify, Teams...)
│ → visual names its logo/wordmark, app icon, and official brand palette explicitly.
│ imageUrl = a public logo or press image URL when you have one.
├── A number, trend, or comparison
│ → chart with labeled axes, units, a source line, and a callout on the key point;
│ brand logos on each series or bar. Or a before/after split scene.
├── A process, stack, or system
│ → diagram whose nodes are the real product icons, not generic boxes.
├── A real person (founder, executive, public figure, historical portrait)
│ → imageUrl = their Wikimedia Commons or press-room portrait, on this slide only.
└── A narrative, emotional, or scene beat
→ imageUrl of a real photo; unsplashQuery only for a real place or physical environment
(concrete noun phrase, ≤120 chars); otherwise a photorealistic studio-lit hero object
or a visual pun where the brand mark interacts with the scene.
Step 1. Choose Format & Slide Count
What kind of X visual post is the user making?
├── Editorial / Educational Breakdown (how-to, teardown, SEO/AI/product playbook)
│ ├── Aspect ratio → 4:5 (portrait)
│ └── Slide count → 6–12 slides (never pad thin material; expand to 13–20 only when the source has 13–20 distinct items)
├── Creative Poster Series / Brand Spec Ads / Visual Gallery
│ ├── Aspect ratio → 3:4 or 4:5 (portrait poster)
│ └── Slide count → exact item count requested, up to 20
└── Compact 2×2 Data Snapshot (4 tight comparison cards)
├── Aspect ratio → 1:1 (square)
└── Slide count → 4 slides
- Never exceed 20 slides for a single X post. Why: X caps single-post image attachments at 20; Slide 21 forces a thread split or fails validation.
- Default to
4:5 portrait whenever the user does not specify an aspect ratio. Why: 4:5 occupies 25% more vertical mobile viewport than 1:1 and avoids horizontal text clipping in X's timeline preview.
Step 2. Choreograph the Feed Preview Grid
X renders multi-image posts as a 2-up or 2×2 preview grid in the timeline before the user taps into full-screen swipe view.
- Slide 1 + Slide 2 are your billboard. Design them to read side-by-side at 50% width on a 390px phone screen:
- Slide 1 (The Tension Hook): Max 8 words in oversized display type (
>= 64pt equivalent) over a hero visual: the brand's logo in its own world, a live product screenshot, or a poster metaphor. Never a generic title like "Guide to SEO" on an empty background.
- Slide 2 (The Proof): A screenshot of the source, a labeled chart, or a before/after split that visually proves Slide 1 is worth tapping.
- Every slide must pass the Standalone Screenshot Test. Include a 2–3 word upper-left category badge on every slide and keep every claim self-contained. Why: X users screenshot and quote-tweet single middle slides (
Slide 7 out of context); a slide titled "Step 4 (continued)" dies outside the carousel.
- Hard copy ceiling: 28 words per slide. One job per slide; if a slide needs both a screenshot and a multi-row table, split it into two slides. Why: a full-screen slide is scanned in ~3 seconds on mobile.
- Preserve source facts verbatim. Keep exact figures (
$412k, 30.5%, 19ms), tool names, and URLs from the user's context, PDFs, or research. Never replace supplied numbers with "XX%" or generic filler.
Step 3. Gather Visual Assets (Mandatory Before Rendering)
Do this before writing a single visual field. Why: the renderer can only show what you hand it; a deck planned without URLs comes back as text cards.
- List every entity and source in the deck: products, companies, models, repos, articles, people-free scenes.
- Find a public URL for each: homepage, pricing page, GitHub repo, status page, docs page, benchmark leaderboard, the primary article. Open it to confirm it loads without a login wall or cookie wall. Why: a screenshot of a sign-in page or consent banner is worse than no screenshot.
- Assign assets:
websiteUrls (deck-level, max 6): the most important pages; GenPPT captures live browser screenshots of them.
slides[].screenshotUrl: the exact page that slide discusses.
slides[].imageUrl: a direct public image URL (logo, press image, chart, photo) 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 in visual instead.
- 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.
- Asset ledger check: every slide has a
screenshotUrl, imageUrl, or unsplashQuery, or its visual names a specific logo, product, chart, or object. Rewrite any slide that has none.
Step 4. Write Concrete visual Prompts and artDirection
visual formula (every slide): [backdrop world] + [hero asset and where it sits] + [logos/icons and placement] + [callout: what it points at] + [headline position].
"Split-screen on deep Azure slate: official 4-color Microsoft logo with Outlook, Teams and M365 app icons top-left, framed browser screenshot of the live status page on the right with a red 'Degraded' callout badge, bold headline at left."
Banned visual values: "timeline bar", "stat card", "giant stat card", "3-bullet summary card", "icon grid", "clean layout", "text slide". Why: vague labels give the renderer nothing to draw except text on a box.
artDirection (3–6 sentences):
- Match the subject's world, never a default black canvas. Brand story → that brand's own palette and saturated backdrop (crimson red, neon green, cobalt blue). Editorial/business → warm bone paper with bold ink. Dev tools → the product's own dark UI. Poster series →
@TheXEffect_-style bold brand-world posters: one saturated backdrop per brand, a photorealistic studio-lit hero object, the logo interacting with the scene. Never use full-bleed #FFFFFF white. Why: pure white blows out on X's dark theme.
- Typography: Bold display headlines, monospace numerals for metrics and step counters (
01 / 10), 48px outer safe margins so X's rounded corners and "1/20" badge never collide with text.
- Layout variety: No two consecutive slides share a layout (framed screenshot → logo poster → labeled chart → before/after split → icon diagram → photo scene).
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 Slides via MCP
Use the GenPPT MCP (genppt_create_slideshow, genppt_get_deck, genppt_revise_slides; swap in another slide-rendering MCP only if the user explicitly asks).
- Author directly—never hand off to a basic prompt rewriter when you already hold the context. Call
genppt_create_slideshow with:
title, thesis (1 sentence), aspectRatio ("4:5", "3:4", or "1:1" from Step 1)
slides: 2–20 objects of { title, purpose, visual, screenshotUrl?, imageUrl?, unsplashQuery? }
websiteUrls, referenceImageUrls, attachmentUrls from Step 3
artDirection from Step 4, 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.
- If GenPPT is not connected or returns
auth_required, give the user the connectUrl / https://genppt.com/mcp setup snippet and the handoffUrl.
- Wait without tight-loop polling:
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. For each slide check:
- Does it show a screenshot, logo, product, photo, chart, or object? A slide that is text on a plain background fails.
- Did the planned screenshot or logo actually appear, and is it legible? A cookie-consent or login modal covering the capture fails.
- Does the stock photo match the subject? A modern object from
unsplashQuery on a historical or metaphor slide fails.
- Is each face only on its own slide?
- Are numbers intact, text clear of the
48px margins, and every border free of crop bleed (a sliver of another image or frame)?
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 composition.
- Screenshot or logo redrawn wrong (garbled UI text, wrong logo) →
placeImages: [{ screenshotUrl or url, x, y, width, height }] with 0..1 coordinates (e.g. { x: 0.08, y: 0.32, width: 0.84, height: 0.52 }). Why: placeImages pastes the real capture untouched instead of letting the model redraw it.
- 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-run genppt_get_deck and re-check. Max 2 revision rounds; if a slide still fails, cut it or tell the user which slide failed and why. Never publish a deck with a text-only slide.
Step 7. Draft the X Post & Publish
Write the tweet text to pair with the 1..20 images:
- Length: Under
240 characters. The slides carry the depth; never write an essay above a 12-slide breakdown.
- Hook: 1 sharp opening line + 1 line stating what's inside (
"10 slides breaking down exact numbers ↓"). 0 hashtags, max 1 emoji, no "In today's fast-paced world".
Then walk the publishing tree:
Is a social publishing MCP, API, or CLI connected in this workspace?
├── Yes → Check the target X account's media limit (up to 20 images) and review policy:
│ ├── Connector flags the account as no-posting (e.g. DM/analytics-only)
│ │ → Do not draft or post via the connector; output copy + rendered slides in chat instead.
│ ├── Autonomous posting explicitly requested AND account permits direct brand publishing
│ │ → Publish the post with the ordered slide image URLs (`1..N`) and return the live post URL.
│ └── Otherwise (default, or review-required / personal profile)
│ → Create a draft (or dry-run preview) with the ordered slide image URLs, show the caption + rendered slides inline, and ask for explicit approval before publishing live.
└── No → Show the rendered slides inline (``), output the ready-to-paste X post copy in a `text` block, and list the ordered slide image URLs + `studioUrl`.
1---2name: x-slideshow-generator3description: Generate X (Twitter) portrait slideshows, multi-photo carousels (up to 20 images per post), and viral poster series via MCP, with live webpage screenshots, brand logos, product UI, and real photos on every slide, then publish or stage them for X. Use when the user asks for an X slideshow, Twitter carousel, 20-image X post, poster series, visual breakdown for X, or turning an article, PDF, repo, or topic into X slide images.4metadata:5 source: https://skillmd.com/skills/illyism/x-slideshow-generator6---78# X (Twitter) Portrait Slideshow & 20-Image Carousel Generator910## The One Rule: Every Slide Shows Concrete Visual Evidence1112**Never ship a slide that is only words, bullets, or a colored bar on a plain background.** *Why*: X users scroll straight past text-on-dark-canvas posters because they read as lazy AI quote cards. A real screenshot, logo, product, or photo is what stops the thumb and proves the claim.1314Every slide gets at least one of these. Walk this tree for each slide:1516```17What is this slide about?18├── A product, site, repo, pricing page, status page, doc, or source article with a public URL19│ → screenshotUrl = that URL. visual: the live page framed in a browser / OS / phone window,20│ with 1–2 callout badges pointing at the exact element that proves the slide's claim.21├── A named company, model, app, or tool (Stripe, OpenAI, Claude, Shopify, Spotify, Teams...)22│ → visual names its logo/wordmark, app icon, and official brand palette explicitly.23│ imageUrl = a public logo or press image URL when you have one.24├── A number, trend, or comparison25│ → chart with labeled axes, units, a source line, and a callout on the key point;26│ brand logos on each series or bar. Or a before/after split scene.27├── A process, stack, or system28│ → diagram whose nodes are the real product icons, not generic boxes.29├── A real person (founder, executive, public figure, historical portrait)30│ → imageUrl = their Wikimedia Commons or press-room portrait, on this slide only.31└── A narrative, emotional, or scene beat32 → imageUrl of a real photo; unsplashQuery only for a real place or physical environment33 (concrete noun phrase, ≤120 chars); otherwise a photorealistic studio-lit hero object34 or a visual pun where the brand mark interacts with the scene.35```3637## Step 1. Choose Format & Slide Count3839```40What kind of X visual post is the user making?41├── Editorial / Educational Breakdown (how-to, teardown, SEO/AI/product playbook)42│ ├── Aspect ratio → 4:5 (portrait)43│ └── Slide count → 6–12 slides (never pad thin material; expand to 13–20 only when the source has 13–20 distinct items)44├── Creative Poster Series / Brand Spec Ads / Visual Gallery45│ ├── Aspect ratio → 3:4 or 4:5 (portrait poster)46│ └── Slide count → exact item count requested, up to 2047└── Compact 2×2 Data Snapshot (4 tight comparison cards)48 ├── Aspect ratio → 1:1 (square)49 └── Slide count → 4 slides50```5152- **Never exceed 20 slides** for a single X post. *Why*: X caps single-post image attachments at 20; Slide 21 forces a thread split or fails validation.53- **Default to `4:5` portrait** whenever the user does not specify an aspect ratio. *Why*: `4:5` occupies 25% more vertical mobile viewport than `1:1` and avoids horizontal text clipping in X's timeline preview.5455## Step 2. Choreograph the Feed Preview Grid5657X renders multi-image posts as a 2-up or 2×2 preview grid in the timeline before the user taps into full-screen swipe view.5859- **Slide 1 + Slide 2 are your billboard.** Design them to read side-by-side at 50% width on a 390px phone screen:60 - **Slide 1 (The Tension Hook):** Max 8 words in oversized display type (`>= 64pt` equivalent) over a hero visual: the brand's logo in its own world, a live product screenshot, or a poster metaphor. Never a generic title like `"Guide to SEO"` on an empty background.61 - **Slide 2 (The Proof):** A screenshot of the source, a labeled chart, or a before/after split that visually proves Slide 1 is worth tapping.62- **Every slide must pass the Standalone Screenshot Test.** Include a 2–3 word upper-left category badge on every slide and keep every claim self-contained. *Why*: X users screenshot and quote-tweet single middle slides (`Slide 7` out of context); a slide titled `"Step 4 (continued)"` dies outside the carousel.63- **Hard copy ceiling: 28 words per slide.** One job per slide; if a slide needs both a screenshot and a multi-row table, split it into two slides. *Why*: a full-screen slide is scanned in ~3 seconds on mobile.64- **Preserve source facts verbatim.** Keep exact figures (`$412k`, `30.5%`, `19ms`), tool names, and URLs from the user's context, PDFs, or research. Never replace supplied numbers with `"XX%"` or generic filler.6566## Step 3. Gather Visual Assets (Mandatory Before Rendering)6768Do this before writing a single `visual` field. *Why*: the renderer can only show what you hand it; a deck planned without URLs comes back as text cards.69701. **List every entity and source** in the deck: products, companies, models, repos, articles, people-free scenes.712. **Find a public URL for each**: homepage, pricing page, GitHub repo, status page, docs page, benchmark leaderboard, the primary article. Open it to confirm it loads without a login wall or cookie wall. *Why*: a screenshot of a sign-in page or consent banner is worse than no screenshot.723. **Assign assets:**73 - `websiteUrls` (deck-level, max 6): the most important pages; GenPPT captures live browser screenshots of them.74 - `slides[].screenshotUrl`: the exact page that slide discusses.75 - `slides[].imageUrl`: a direct public image URL (logo, press image, chart, photo) 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 in `visual` instead.76 - **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.77 - `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.78 - `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.794. **Asset ledger check:** every slide has a `screenshotUrl`, `imageUrl`, or `unsplashQuery`, or its `visual` names a specific logo, product, chart, or object. Rewrite any slide that has none.8081## Step 4. Write Concrete `visual` Prompts and `artDirection`8283**`visual` formula** (every slide): `[backdrop world] + [hero asset and where it sits] + [logos/icons and placement] + [callout: what it points at] + [headline position]`.8485> *"Split-screen on deep Azure slate: official 4-color Microsoft logo with Outlook, Teams and M365 app icons top-left, framed browser screenshot of the live status page on the right with a red 'Degraded' callout badge, bold headline at left."*8687**Banned `visual` values**: `"timeline bar"`, `"stat card"`, `"giant stat card"`, `"3-bullet summary card"`, `"icon grid"`, `"clean layout"`, `"text slide"`. *Why*: vague labels give the renderer nothing to draw except text on a box.8889**`artDirection` (3–6 sentences):**901. **Match the subject's world, never a default black canvas.** Brand story → that brand's own palette and saturated backdrop (crimson red, neon green, cobalt blue). Editorial/business → warm bone paper with bold ink. Dev tools → the product's own dark UI. Poster series → `@TheXEffect_`-style bold brand-world posters: one saturated backdrop per brand, a photorealistic studio-lit hero object, the logo interacting with the scene. Never use full-bleed `#FFFFFF` white. *Why*: pure white blows out on X's dark theme.912. **Typography:** Bold display headlines, monospace numerals for metrics and step counters (`01 / 10`), `48px` outer safe margins so X's rounded corners and `"1/20"` badge never collide with text.923. **Layout variety:** No two consecutive slides share a layout (framed screenshot → logo poster → labeled chart → before/after split → icon diagram → photo scene).9394**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.9596## Step 5. Render Slides via MCP9798Use the **GenPPT MCP** (`genppt_create_slideshow`, `genppt_get_deck`, `genppt_revise_slides`; swap in another slide-rendering MCP only if the user explicitly asks).991001. **Author directly—never hand off to a basic prompt rewriter when you already hold the context.** Call `genppt_create_slideshow` with:101 - `title`, `thesis` (1 sentence), `aspectRatio` (`"4:5"`, `"3:4"`, or `"1:1"` from Step 1)102 - `slides`: `2–20` objects of `{ title, purpose, visual, screenshotUrl?, imageUrl?, unsplashQuery? }`103 - `websiteUrls`, `referenceImageUrls`, `attachmentUrls` from Step 3104 - `artDirection` from Step 4, `autoRender: true`105 - 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`.106 - If GenPPT is not connected or returns `auth_required`, give the user the `connectUrl` / `https://genppt.com/mcp` setup snippet and the `handoffUrl`.1072. **Wait without tight-loop polling:** `genppt_get_deck` with `{ deckId, waitSeconds: 45 }` until `phase === "ready"`.108109## Step 6. Visual QA Gate (Mandatory Before Publishing)110111Open every `slideImageUrls` image and look at it. For each slide check:112- Does it show a screenshot, logo, product, photo, chart, or object? A slide that is text on a plain background **fails**.113- Did the planned screenshot or logo actually appear, and is it legible? A cookie-consent or login modal covering the capture **fails**.114- Does the stock photo match the subject? A modern object from `unsplashQuery` on a historical or metaphor slide **fails**.115- Is each face only on its own slide?116- Are numbers intact, text clear of the `48px` margins, and every border free of crop bleed (a sliver of another image or frame)?117118Fix every failing slide with `genppt_revise_slides`: `{ deckId, revisions: [{ slideNumber, instructions, screenshotUrl?, imageUrl?, placeImages? }] }`.119- Missing visual → add `screenshotUrl` or `imageUrl` plus instructions describing the composition.120- Screenshot or logo redrawn wrong (garbled UI text, wrong logo) → `placeImages: [{ screenshotUrl or url, x, y, width, height }]` with `0..1` coordinates (e.g. `{ x: 0.08, y: 0.32, width: 0.84, height: 0.52 }`). *Why*: `placeImages` pastes the real capture untouched instead of letting the model redraw it.121- 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.122- 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.123- A face on the wrong slide → revise that slide with instructions to remove the person; keep the portrait on its own slide's `imageUrl`.124- Crop bleed at a border → revise with instructions to keep every element inside the slide edges.125126Re-run `genppt_get_deck` and re-check. Max 2 revision rounds; if a slide still fails, cut it or tell the user which slide failed and why. Never publish a deck with a text-only slide.127128## Step 7. Draft the X Post & Publish129130Write the tweet text to pair with the `1..20` images:131- **Length:** Under `240` characters. The slides carry the depth; never write an essay above a 12-slide breakdown.132- **Hook:** 1 sharp opening line + 1 line stating what's inside (`"10 slides breaking down exact numbers ↓"`). 0 hashtags, max 1 emoji, no `"In today's fast-paced world"`.133134Then walk the publishing tree:135136```137Is a social publishing MCP, API, or CLI connected in this workspace?138├── Yes → Check the target X account's media limit (up to 20 images) and review policy:139│ ├── Connector flags the account as no-posting (e.g. DM/analytics-only)140│ │ → Do not draft or post via the connector; output copy + rendered slides in chat instead.141│ ├── Autonomous posting explicitly requested AND account permits direct brand publishing142│ │ → Publish the post with the ordered slide image URLs (`1..N`) and return the live post URL.143│ └── Otherwise (default, or review-required / personal profile)144│ → Create a draft (or dry-run preview) with the ordered slide image URLs, show the caption + rendered slides inline, and ask for explicit approval before publishing live.145└── No → Show the rendered slides inline (``), output the ready-to-paste X post copy in a `text` block, and list the ordered slide image URLs + `studioUrl`.146```