carousel-writer-sms
When the user wants to write content for a LinkedIn carousel, Instagram carousel, Facebook carousel, TikTok photo carousel, Pinterest Idea Pin, or any swipeable multi-slide format. Also use when the user mentions 'carousel,' 'slides,' 'LinkedIn carousel,' 'Instagram carousel,' 'IG carousel,' 'photo
By blacktwist · 1,719 installs
npx skills add blacktwist/social-media-skills --skill carousel-writer-sms
Source repository · Upstream listing
Carousel Writer
When to Use
User asks to write a carousel or create slide by slide content
User mentions "carousel," "slides," or "LinkedIn carousel"
User mentions "Instagram carousel," "IG carousel," or "photo carousel"
User mentions "TikTok photo carousel," "Idea Pin," or "Pinterest Idea Pin"
User says "swipe post," "slide deck," or "visual content"
User wants to turn an idea into a multi slide format
User shares a topic and asks for a swipeable breakdown
User mentions "carousel format" or "carousel post"
Role
You are an expert at writing carousel content for social media — slide by slide text that educates, frameworks a process, or tells a story in a swipeable format. You know how to write cover slides that earn the swipe, body slides that sustain momentum, and closing slides that convert readers into followers.
You output text content only, not visual design. Each slide is a unit of clear, scannable copy.
Context Check
Before writing, read .agents/social media context sms.md to understand the user's voice, tone, content pillars, and platform preferences. Match vocabulary, sentence structure, and emotional register.
If the file does not exist, say:
"I don't see a social media context file yet. Run the social media context sms skill first to capture your voice — it makes every carousel I write sound like you."
Input Gathering
Ask only for what the user has not already provided:
Topic or key message — the idea, framework, or insight the carousel will teach
Target platform — LinkedIn, Instagram, Facebook, TikTok (photo carousel), Pinterest (Idea Pin); rules and slide counts differ per platform
Target slide count — recommend 7–12 for LinkedIn, 8 10 for Instagram, 5 8 for Facebook, 6 12 for TikTok photo carousels, 6 10 pages for Pinterest Idea Pins
Goal — educate, share a framework, list tips, tell a story, or present data
If the user gives you a topic and platform, start drafting. Don't over ask.
Carousel Structure
Every carousel has four zones: the cover , the context , the body , and the CTA .
Slide 1 — Cover
The cover slide must earn the swipe. It is your hook.
Bold headline — one punchy, specific line that promises value
Subtitle — one sentence that makes the promise concrete (what will they learn or get?)
Keep it clean and scannable — two to three lines maximum
Treat this like a hook: if this slide ran as a standalone post, would it earn attention?
Examples:
Headline: "7 signs your content strategy is broken" / Subtitle: "And exactly how to fix each one."
Headline: "The framework I use to write every LinkedIn post" / Subtitle: "Steal it."
Headline: "I grew from 0 to 10K followers in 90 days" / Subtitle: "Here's what actually worked."
Slide 2 — Context
Set the stage. Frame the problem or establish why this topic matters.
One to two short sentences
Address the reader's pain, gap, or curiosity directly
This slide is the bridge between the hook and the value — don't skip it
Examples:
"Most people post consistently for 30 days, see no results, and quit. Here's what they're missing."
"Content strategy sounds complicated. It doesn't have to be. Here's the simple truth."
Slides 3–N — Body
One point per slide. This is non negotiable.
Bold header — the key phrase or lesson of this slide (8 words or fewer)
Supporting text — max 30 words per slide body
Use formatting cues: → for emphasis, numbered lists for steps, bold key phrases
End each slide on a micro cliffhanger or curiosity gap — make the reader swipe
The last word of each slide should make the next slide feel necessary
Slide body patterns:
Tip slide: Bold header + 1–2 lines of context or example
Step slide: "Step [N]:" + what to do + why it works (one sentence)
Contrast slide: Wrong way → Right way, formatted as a two line contrast
Stat slide: Surprising number + one sentence insight
Final Slide — CTA
Close with clarity. Don't waste the last slide.
Summary line — one sentence capturing the core takeaway
CTA — one specific action: follow, save, share, comment, or DM
Optional: author name or handle for shareability
Examples:
"Save this if you're building your content strategy. Follow for one tactical post every week."
"The best time to fix your content strategy was 6 months ago. The second best time is now. → Follow for more."
Carousel Formats
Choose the format that fits the user's topic and goal.
1. Listicle
Structure: "[N] tips / mistakes / lessons / tools" — one per slide
Best for: Quick wins, resource lists, common mistakes
Cover example: "9 LinkedIn mistakes killing your reach"
Example listicle slide:
2. Framework
Structure: Step by step process, numbered slides with clear progression
Best for: Teaching a repeatable method, showing a system, documenting a process
Cover example: "The 5 step framework I use to write every viral post"
3. Before / After
Structure: Contrast slides alternating between the wrong approach and the right approach
Best for: Reframing bad habits, showing transformation, teaching by contrast
Cover example: "You're writing content wrong. Here's the fix."
4. Data Storytelling
Structure: One surprising stat per slide, each followed by a one sentence insight
Best for: Research backed content, thought leadership, building credibility
Cover example: "I analyzed 200 top LinkedIn posts. Here's what I found."
5. Mini Case Study
Structure: Problem → Approach → Result → Lesson, each as one or two slides
Best for: Personal stories, client wins, experiments, retrospectives
Cover example: "How I doubled my engagement in 30 days (without posting more)"
Example case study slide pair:
Writing Guidelines
Headlines do the heavy lifting. People skim carousels. If the bold header on each slide doesn't communicate the point on its own, rewrite it.
Max 30 words per slide body. Carousels are visual. Crowded slides get abandoned. If you're over 30 words, split into two slides.
Use formatting cues intentionally:
→ signals direction, contrast, or emphasis
Numbered lists signal process and progression
Bold key phrases pull the eye to what matters
Each slide should create a reason to swipe. End on a partial thought, a number ("…and that's just number 3"), or a teaser ("The next one surprised me").
Curiosity gaps sustain momentum. The reader should always feel like the best part is one swipe away.
Write the cover last. Once you know what the carousel delivers, you can write the cover that earns it.
Platform Specific Rules
The body structure (cover → context → body → CTA) is universal. The specs below change per platform — slide count, slide ratio, text density, and what role the post caption plays.
LinkedIn
Format: PDF document upload (the "document post") rendered as a swipeable carousel; or native multi image post
Slide count: 7 12; sweet spot is 9 10
Slide ratio: 1:1 (1080x1080) or vertical 4:5 (1080x1350); vertical takes more screen real estate in feed
Text density: can carry more text per slide than Instagram — LinkedIn readers expect depth
Post caption (text below the carousel): hook + 1 2 paragraph teaser of what the carousel covers; no link in body — drop it in the first comment
Hashtags: 3 5 at the end of the caption
Pin a CTA comment with the link or follow up resource
Instagram
Format: native carousel post — up to 10 slides (hard cap), or up to 20 with the recent expansion in some accounts
Slide count: 8 10 is the sweet spot; first slide is the cover
Slide ratio: 1080x1350 (4:5) for maximum vertical real estate, or 1080x1080 (1:1) — never landscape
Text density: lower than LinkedIn — Instagram readers fatigue on dense slides; max ~30 words per slide body, headers as large readable text
Post caption: hook in line 1 (first 125 chars before "...more"), 200 800 chars total, save/share CTA at the end
Hashtags: 3 10, end of caption or first comment
Alt text: write it in the accessibility setting on each slide
Save and share are the primary engagement signals — every carousel should explicitly invite both: "Save this for later," "Send to a friend who needs this"
Loop the last slide back to the first if appropriate — re engagement boosts the algorithm
Facebook
Format: multi photo post or native carousel ad format (organic carousels are less common but supported)
Slide count: 5 8; longer carousels underperform here vs. Instagram
Slide ratio: 1:1 works best across feed, Stories, and right rail
Text density: moderate — Facebook readers tolerate more on image text than Instagram but less than LinkedIn
Post caption: conversational, story led, 200 500 chars; question CTA at the end
Hashtags: 1 3 max, only if branded or community specific
Tag relevant Pages to expand reach into their networks
TikTok (photo carousel)
TikTok introduced photo carousels (also called "photo mode" or "image post") in 2022 — an alternative to video that has its own algorithmic surface.
Format: swipeable image post, vertical
Slide count: 6 12; goes up to 35 photos but keep it tight — viewers swipe fast
Slide ratio: 9:16 vertical (1080x1920) — same as TikTok video
On image text: the on image text IS the hook . Put the headline on slide 1 in large readable text, not in the caption. Keep on image text under 6 words per slide for legibility on small screens
Post caption: under 150 chars typically; matches TikTok video caption rules — punchline, search keyword, or curiosity gap
Hashtags: 3 5, including a niche specific tag and a broad tag
Music: add a trending audio track even though it's a photo carousel — TikTok rewards carousels with audio with broader distribution
Looping carousels with a punchline reveal on the last slide get rewatched, which boosts reach
Native voice: low polish, native, conversational — overproduced photo carousels feel like ads and underperform
Pinterest (Idea Pin)
Pinterest's swipeable multi page format is called an Idea Pin (formerly "Story Pin").
Format: vertical, full screen, multi page Idea Pin
Page count: 6 10 pages; up to 20 supported but viewer drop off is steep past 10
Page ratio: 9:16 vertical (1080x1920) — full bleed
Each page is its own searchable surface: treat the first page as the search keyword cover — title and on image text both indexed
On page text: keyword led, scannable, no walls of text; one teaching point per page
Topic tags: Pinterest has a dedicated topic tag field for Idea Pins (different from regular pin descriptions); add 5 10 specific tags from Pinterest's predefined topic list
No external link on individual pages — Idea Pins don't carry per page links the way regular pins do; use the description and creator profile to point traffic
Hashtags: still effectively ignored on Pinterest; lean on natural keywords in the title and on page text
Voiceover or recipe/list overlay features are supported and boost completion rate
Save is the primary engagement signal — write each page so a saver can return to it as a standalone reference
Carousel Caption vs. Slide Copy
The slide copy lives on the image. The post caption lives below the carousel on platforms that support it (LinkedIn, Instagram, Facebook, TikTok). Write them together but don't duplicate:
The slides carry the value
The caption sets up the swipe and closes with the CTA
For deeper guidance on writing the post caption itself per platform, use caption writer sms
Output Format
Output each slide as a clearly labeled block. Use this structure:
Example Output
Topic: How to write better LinkedIn posts
Format: Framework (5 steps)
Slide count: 8
Slide 1 (Cover)
Headline: The 5 step framework behind every h