Agent skill

Carousel Writer

by social-media-skills in social-media-skills/skills

A skill your agent uses to write a carousel — a swipeable multi-slide post (Instagram carousel, LinkedIn document/PDF carousel, or TikTok photo carousel) — one of the highest-save, highest-dwell…

MITAuto-check passedDocuments & Office

Install Carousel Writer

skills CLI
$ npx skills add social-media-skills/skills --skill carousel-writer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install social-media-skills/skills carousel-writer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/social-media-skills/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/carousel-writer .claude/skills/carousel-writer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
carousel-writer
GitHub stars
134
Token cost
~1.6k tokens
SKILL.md length
793 words
Files
7 (incl. references)
Skills in repo
106
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses to write a carousel — a swipeable multi-slide post (Instagram carousel, LinkedIn document/PDF carousel, or TikTok photo carousel) — one of the highest-save, highest-dwell…

  • Works in 8 steps: Read the foundation first → Lock the idea, goal, and platform → Write the cover slide (hook + promise) → …
  • Write a carousel — a swipeable multi-slide post (Instagram carousel
  • SKILL.md covers Step 0 — Read the foundation…, Step 1 — Lock the idea, goal,…, Step 2 — Write the cover slide… and Step 3 — Architect the carousel, plus 8 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Carousel Writer is an agent skill from social-media-skills/skills. Use to write a carousel — a swipeable multi-slide post (Instagram carousel, LinkedIn document/PDF carousel, or TikTok photo carousel) — one of the highest-save, highest-dwell formats. Run when the user says "write a carousel," "carousel post," "slides for X," "LinkedIn document/PDF post," "swipe post," "turn this into a carousel," or wants multi-slide teaching or story content. Reads brand-profile and voice first; the cover slide hooks and promises the swipe (via hook-writer); each slide advances one idea and…

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including reference files (for example `evals/evals.json`, `references/architecture.md` and `references/examples.md`).

It sits in Documents & Office, covering Slides and decks and Image generation. It works with LinkedIn, Instagram, TikTok and Google Gemini. The repository describes itself as: 106 social media skills for AI agents - strategy, writing, video, design, platform growth, publishing, and analytics. Works with Claude, Cursor, OpenClaw, Hermes & 40+ agents. The licence is MIT.

When your agent uses it

  • Write a carousel — a swipeable multi-slide post (Instagram carousel
  • LinkedIn document/PDF carousel
  • TikTok photo carousel) — one of the highest-save
  • Highest-dwell formats

Example prompts

  • “write a carousel,”
  • “carousel post,”
  • “slides for X,”
  • “/carousel-writer”

Workflow steps

8 steps, taken from the step headings in SKILL.md.

  1. Read the foundation first
  2. Lock the idea, goal, and platform
  3. Write the cover slide (hook + promise)
  4. Architect the carousel
  5. Write the slides
  6. Land the payoff and a save-leaning CTA
  7. Specify the visuals (design direction + image pack)
  8. Hand off

What it can do on your machine

Read from SKILL.md and the folder at commit 6e30eeb. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Carousel Writer loads about 1.6k tokens when it runs, and up to ~5.5k if it reads all its reference files. Until then it costs about 195 tokens; SKILL.md has 793 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~195
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from social-media-skills/skills at commit 6e30eeb, republished under its MIT licence (© social-media-skills). 793 words, ~1,649 tokens.

Download SKILL.mdSave it as .claude/skills/carousel-writer/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
carousel-writer
description
Use to write a carousel — a swipeable multi-slide post (Instagram carousel, LinkedIn document/PDF carousel, or TikTok photo carousel) — one of the highest-save, highest-dwell formats. Run when the user says "write a carousel," "carousel post," "slides for X," "LinkedIn document/PDF post," "swipe post," "turn this into a carousel," or wants multi-slide teaching or story content. Reads brand-profile and voice first; the cover slide hooks and promises the swipe (via hook-writer); each slide advances one idea and earns the next swipe; ends on a save-leaning CTA. Specifies the design direction and bundles an image-generation prompt pack (Nano Banana / Ideogram) for the slide visuals. Hands the caption to caption-writer and scheduling to scheduling-and-queue.
metadata.version
1.0.0
license
MIT

A carousel is a swipeable teaching-or-story post — and one of the best formats there is for saves and dwell time (both strong ranking signals). But it only works if people swipe, and they only swipe if each slide earns the next. So this skill is opinionated about the cover, the one-idea-per-slide discipline, and keeping slides legible — not dumping paragraphs onto images.

Three principles:

  1. The cover slide is the whole game. Slide 1 must hook and promise the payoff — it decides whether anyone swipes past it. Treat it like a thread opener or a Reel hook.
  2. One idea per carousel, one idea per slide. A cohesive arc across slides, each advancing it by one beat. A slide crammed with three points loses the swipe.
  3. It's copy and design. Minimal, legible text per slide; a clear visual hierarchy. A carousel is read at a glance on a phone — walls of text kill it.

Step 0 — Read the foundation first

Load brand-profile.md and voice.md. Voice applies to every slide (concise) and to the caption. Carry guardrails and any compliance/disclosure rules.

Step 1 — Lock the idea, goal, and platform

  • One idea — the single thing this carousel teaches or tells.
  • Goal — usually saves or authority (carousels excel here), sometimes comments.
  • Platform — Instagram carousel, LinkedIn document/PDF carousel (very high dwell/saves), or TikTok photo carousel. Specs differ (see references/platform-specs.md).

Step 2 — Write the cover slide (hook + promise)

Use hook-writer. The cover must hook (stop the scroll) and promise what the swipe delivers ("5 hooks that actually work →"). It must be legible at a glance and at thumbnail size. No slow-build cover. See references/slide-craft.md.

Pick a structure (how-to, listicle, story, before→after, myth-bust, framework — see references/architecture.md) and outline the spine: the cover's promise and the ordered slides that deliver it. One idea per slide. Decide slide count by the idea, not a target — a tight 6 beats a padded 10.

Step 4 — Write the slides

Each slide: a clear headline + at most a short supporting line, front-loaded and legible. Maintain swipe momentum (progress, a small pull forward). Keep every slide in the brand voice and ruthlessly minimal — if it needs a paragraph, it's two slides. See references/slide-craft.md.

Step 5 — Land the payoff and a save-leaning CTA

End with a payoff/summary slide, then a CTA slide. Carousels win on saves, so the default CTA is "save this for later" (plus optionally follow/comment). One ask. A link, if any, goes to the caption/bio/first comment per platform.

Step 6 — Specify the visuals (design direction + image pack)

A carousel is visual. Provide:

  • Design direction — layout, hierarchy, palette, type, and a consistent template across slides (consistency is what makes it look pro).
  • The image-generation prompt pack — bundled prompts (Nano Banana / Ideogram, which render legible in-image text) to produce on-brand slides, with the exact slide text specified. Or a clean template spec for Canva/a designer. Flag AI-disclosure for generated images. See references/image-prompt-pack.md. (For deeper visual systems, see design-and-templates.)
Show full SKILL.md (300 more words)Show less

Step 7 — Hand off

  • Caption: the carousel post needs a caption that pulls people into slide 1 → caption-writer.
  • Schedule: hand the finished carousel + caption to scheduling-and-queue.

Quality bar — self-check

  • Does the cover hook AND promise the swipe, legible at a glance?
  • Is it one idea, with a clear spine — one idea per slide, no crammed slides?
  • Does each slide earn the next swipe (momentum, no filler slides)?
  • Is the text minimal and legible on mobile — not a wall?
  • Does it end on a payoff + one save-leaning CTA?
  • Is there a consistent design direction and an image pack (or template) to produce it?
  • Is AI-disclosure handled for generated visuals; no fabricated stats on slides?
  • On-voice throughout?

Edge cases & pushback

  • "Make it 10 slides" when the idea is 5 → resist padding; a tight carousel beats a bloated one. Offer the strongest N, not a quota.
  • Better as something else → a single point is a single image; a dynamic story is often a Reel; a text argument may be a thread. Say so rather than forcing a carousel.
  • Text-heavy source (a blog) → atomize into one idea per slide, don't paste paragraphs (see cross-platform-repurposing).
  • No design tool / no AI images → provide a clean text-template spec that works on a simple branded background; don't block on production.
  • Regulated/sensitive → carry compliance guardrails onto slides; only verifiable claims.
  • brand-profile, voice-builder — voice + guardrails.
  • hook-writer — the cover hook.
  • design-and-templates — deeper visual design system for slides.
  • caption-writer — the post caption; cross-platform-repurposing — source → carousel.
  • nano-banana, ideogram (creative-tool mini-skills) — generate the slide visuals.
  • scheduling-and-queue — schedule the finished carousel.

References

  • references/architecture.md — carousel structures, the spine, one-idea-per-slide, slide count.
  • references/slide-craft.md — slide-level writing + visual hierarchy + the cover formula.
  • references/platform-specs.md — IG / LinkedIn document / TikTok carousel specs.
  • references/image-prompt-pack.md — the bundled image-generation prompt pack (Nano Banana/Ideogram).
  • references/examples.md — worked carousels slide-by-slide, with prompts, vs a text-dump version.

© social-media-skills, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 6 other files (references) in skills/carousel-writer of social-media-skills/skills.

  • SKILL.md
  • evals/evals.json
  • references/architecture.md
  • references/examples.md
  • references/image-prompt-pack.md
  • references/platform-specs.md
  • references/slide-craft.md

Open the folder on GitHubat commit 6e30eeb

Compare with similar skills

Carousel Writer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Carousel Writer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Carousel Writer this skillsocial-media-skills/skills134—~1.6kAutomated safety check: PassMIT
Threads Carouselitchernetski/threads-carousel-claude-skill110—~3.5kAutomated safety check: PassMIT
Carousel Writer Smsblacktwist/social-media-skills560—~4.1kAutomated safety check: PassMIT
CarouselsTheCraigHewitt/skills159—~2.3kAutomated safety check: PassMIT
DesignOhh-889/skyroc7959 repos~3.1kAutomated safety check: PassMIT
Gemini Carouselcharlie947/social-media-skills3.8k—~1.7kAutomated safety check: PassMIT

Similar skills

  • Threads Carousel

    itchernetski/threads-carousel-claude-skill

    Convert text posts into visual carousel images or presentations for Threads, Instagram, LinkedIn, TikTok, YouTube.

    110 GitHub stars~3.5k tokensUpdated 5 mo ago
    Documents & OfficeAuto-check passed
  • Carousel Writer Sms

    blacktwist/social-media-skills

    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.

    560 GitHub stars~4.1k tokensUpdated 5 mo ago
    Documents & OfficeAuto-check passed
  • Carousels

    TheCraigHewitt/skills

    Turns a piece of Craig's content (an email, a YouTube script, an essay, or pasted text) into a polished image carousel publishable to both LinkedIn and Instagram from one set of 1080x1350 slides.

    159 GitHub stars~2.3k tokensUpdated 4 mo ago
    Media & CreativeAuto-check passed
  • Design

    Ohh-889/skyroc

    Comprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations…

    795 GitHub starsUsed in 9 repos~3.1k tokens
    Frontend & DesignAuto-check passed
  • Gemini Carousel

    charlie947/social-media-skills

    Generate a branded slide-by-slide LinkedIn carousel using Gemini.

    3.8k GitHub stars~1.7k tokensUpdated 26 days ago
    Media & CreativeAuto-check passed
  • Social Media Carousel

    danielmeppiel/agentic-sdlc-handbook

    Multi-slide carousel design for Instagram, LinkedIn, and Twitter/X with layout rules and hooks.

    158 GitHub starsUsed in 1 repo~2.2k tokens
    Documents & OfficeAuto-check passed

More from social-media-skills/skills

All 106 skills in this repo
  • AI Image Editing

    social-media-skills/skills

    The AI image-editing router — inpainting/object removal, background removal, upscaling, outpainting, old-photo restoration, and retouch, routed task-first to the right engine.

    134 GitHub stars~2.1k tokensUpdated 9 days ago
    Auto-check passed
  • AI Music And Sound

    social-media-skills/skills

    The AI music + sound-design skill for social -- original/licensed audio beds and sound design for Reels/TikToks/Shorts/videos.

    134 GitHub stars~1.9k tokensUpdated 9 days ago
    Auto-check passed
  • AI Search Optimization

    social-media-skills/skills

    A skill your agent uses to get a brand and its content CITED and RECOMMENDED by AI answer engines — the GEO (Generative Engine Optimization) / AI-search-visibility skill.

    134 GitHub stars~2k tokensUpdated 9 days ago
    Auto-check passed
  • AI Video

    social-media-skills/skills

    The model-agnostic AI-video router and brief — the counterpart to image-prompt.

    134 GitHub stars~1.3k tokensUpdated 9 days ago
    Auto-check passed
  • AI Voiceover

    social-media-skills/skills

    The AI narration / voiceover mini-skill (ElevenLabs-led). An agent skill from social-media-skills/skills.

    134 GitHub stars~1.1k tokensUpdated 9 days ago
    Auto-check passed
  • Analytics And Reporting

    social-media-skills/skills

    Social media analytics and reporting — read native platform data honestly and turn it into next actions.

    134 GitHub stars~1.4k tokensUpdated 9 days ago
    Auto-check passed

Questions about Carousel Writer

What does Carousel Writer do?

A skill your agent uses to write a carousel — a swipeable multi-slide post (Instagram carousel, LinkedIn document/PDF carousel, or TikTok photo carousel) — one of the highest-save, highest-dwell…. Carousel Writer is an agent skill from social-media-skills/skills. Use to write a carousel — a swipeable multi-slide post (Instagram carousel, LinkedIn document/PDF carousel, or TikTok photo carousel) — one of the highest-save, highest-dwell formats.

When should I use Carousel Writer?

Carousel Writer fits situations like: write a carousel — a swipeable multi-slide post (Instagram carousel; linkedIn document/PDF carousel; tikTok photo carousel) — one of the highest-save; highest-dwell formats.

How do I install Carousel Writer in Claude Code?

Run `npx skills add social-media-skills/skills --skill carousel-writer -a claude-code`. Or copy the skill folder (skills/carousel-writer in social-media-skills/skills) into .claude/skills/carousel-writer in your project. Claude Code loads it when a task matches its description.

How do I install Carousel Writer in Codex?

Run `npx skills add social-media-skills/skills --skill carousel-writer -a codex`. Or copy the skill folder (skills/carousel-writer in social-media-skills/skills) into .agents/skills/carousel-writer in your project. Codex loads it when a task matches its description.

Can I use Carousel Writer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add social-media-skills/skills --skill carousel-writer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/carousel-writer, .gemini/skills/carousel-writer, .github/skills/carousel-writer and .opencode/skills/carousel-writer in your project.

What does Carousel Writer need to run?

SKILL.md names no scripts, command-line tools or credentials: Carousel Writer is instructions for the agent only.

Does Carousel Writer access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Carousel Writer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Carousel Writer use?

Carousel Writer is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Carousel Writer use?

About 1.6k tokens (SKILL.md is roughly 6.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.9k tokens, read only when the agent opens those files.

What are the alternatives to Carousel Writer?

Skills that share tags, products or a category with Carousel Writer: Threads Carousel (itchernetski/threads-carousel-claude-skill, 110 stars), Carousel Writer Sms (blacktwist/social-media-skills, 560 stars), Carousels (TheCraigHewitt/skills, 159 stars) and Design (Ohh-889/skyroc, 795 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Carousel Writer?

social-media-skills (a GitHub organization) maintains it in social-media-skills/skills, which has 134 GitHub stars. The repository holds 106 skills in this directory. The repository was last updated on October 1, 2026.

Source: social-media-skills/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.