MCPInstall

ig-carousel-planner

Plan an Instagram carousel slide by slide, up to 10 slides, with a hook slide that opens a loop, value slides that front-load the payoff, and a payoff slide that earns the save and follow. Picks a 2026 carousel formula (listicle, before/after, myth-buster, framework) by goal (saves, shares, follows), drafts each slide's text plus the caption, then publishes the images you supply via Publora. Use to structure a multi-slide carousel. Not for single-image captions (use ig-caption-writer).

Installs
54
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/sergebulaev/instagram-skills --skill ig-carousel-planner
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads ig-carousel-planner automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Instagram Carousel Planner

Plan a carousel that gets swiped to the end and saved. The whole game is slide 1 (the swipe-earning hook) and the last slide (the saveable payoff). This skill maps every slide, writes the on-image text, and drafts the caption that frames it.

When to use

  • User wants to turn a topic or notes into a multi-slide carousel
  • User has a list, a framework, or a transformation to teach
  • User wants a slide-by-slide structure, not just a caption

Formulas this skill uses (carousel shapes)

CodeFormulaPrimary goalBest for
IG5Listicle Carouselsavesa numbered teaching list, one item per slide
IG6Before/After Transformationsaves, followsproof of a result with the steps between
IG7Myth-Bustersharescorrecting beliefs your niche holds
IG8Steal-This Frameworksavesa named, repeatable framework

Full skeletons in ../../references/hook-formulas.md.

Slide architecture (the 10-slide spine)

A carousel is 2-10 slides (API limit). The reliable spine:

SlideRole
1 (hook)the promise + an open loop ("most miss #4"). Earns the swipe. Big text, one idea.
2-3the strongest value, front-loaded (swipe-through decays with depth).
4 to N-1one point per slide, each standing alone, each readable in 2 seconds.
N (payoff)the one-slide summary (the saveable artifact) + one clear ask (save / follow).

6-10 slides is the sweet spot for a teaching carousel. Fewer than 4 is usually a single image. See references/slide-architecture.md for per-formula spines.

Steps

Voice profile first (all drafts). If ../../references/voice-profile.md has filled: yes, load it and match the user's voice fingerprint, hard rules, and CTA/link style throughout. If it is not filled, mention once that ig-humanizer --mode profile can learn their voice from a few posts, then proceed with the generic voice rules.

Never invent the specifics. The rules below ask for a concrete number, a date and a named entity, because that is what separates a real post from a generated one. Take them from what the user actually said in this conversation. Do not invent a figure, a date, a client name or a result, and do not soften a vague claim into a plausible-looking number. If the user has nothing concrete for a beat, ask them once, and if they still have nothing, drop the claim rather than decorate it. A published invented number is a retraction; a missing one is only a weaker post.

  1. Gather inputs. Topic, the list/framework/transformation, target audience, and the goal (saves / shares / follows).
  2. Pick the formula. Use the goal table; suggest 2-3 that fit and let the user choose.
  3. Set the slide count. Match it to the real content (6-10 typical). Never pad to hit 10; viewers feel filler and bail.
  4. Write slide 1. The promise plus the loop. Big, single-idea on-image text. Front-load a number if one fits.
  5. Map the value slides. Put the strongest point on slide 2 or 3. One point per slide, each able to stand alone. Draft the on-image text for each (keep it short, it has to read in 2 seconds on a 4:5 frame).
  6. Write the payoff slide. A one-slide recap that is worth saving on its own, plus a single ask (save it / follow for more).
  7. Write the caption. The caption supports the carousel (it can be short), restates the hook for the fold, and carries the hashtags. Hand off to ig-hashtag-strategist or apply the 3-5 sized set.
  8. Humanizer pass on the on-image text and caption. Scrub 2026 AI vocab by density (per slide, per caption paragraph), cap em dashes (at most one per slide, about one per 100 words in the caption; never swap one for a period), break stacked triads and reveal bridges. Slides are short by design: never chop or pad a slide for rhythm. Canonical rules: ig-humanizer V3.
  9. Approval card. Show: formula, slide-by-slide outline with each slide's text, the caption, hashtag set, primary goal, and a reminder that the user supplies 2-10 images (all images, no mixed media) in this order.
  10. On approval, publish with media. Call lib.publish(kind="carousel", draft_text=<approved caption>, target_url="https://www.instagram.com/", media=[<slide image paths in order>], platforms=[<INSTAGRAM_PLATFORM_ID>], scheduled_time=<iso_or_None>). The wrapper uploads each image in order and schedules. With no media or no Publora key it returns the plan as a copy-paste block plus the slide order.

Hard rules

Global voice rules: see root SKILL.md Voice rules. Additional skill-specific rules:

  • Slide 1 is a promise with an open loop, never a bare title.
  • Front-load value to slides 2-3; never bury the best point at the end.
  • One point per slide, readable in 2 seconds on a portrait 4:5 frame.
  • 2-10 slides only. Never pad to a round number.
  • All images, no mixed media (the API rejects an image+video carousel).
  • The last slide must earn the save with a one-slide summary and one ask.

Anti-patterns (skill will refuse)

  • A title-only slide 1 with no promise or loop.
  • A 10-slide carousel padded from a 4-point idea.
  • The strongest point saved for the final slide.
  • Three competing CTAs on the payoff slide.
  • Mixing images and a video in one carousel.
  • On-image walls of text that cannot be read in a swipe.
  • Em dashes above the cap (more than one on a slide), AI vocab clusters, stacked or hollow rule-of-three.
  • "The result?" reveals and staccato stacks added for punch.

Resources

  • ../../references/hook-formulas.md - the carousel formulas (IG5-IG8) with skeletons
  • ../../references/algorithm-heuristics.md - 2026 carousel ranking and swipe-through rules
  • ../../references/hashtag-strategy.md - the 3-5 sized hashtag recipe
  • ../../references/media-workflow.md - uploading 2-10 images in order
  • references/slide-architecture.md - per-formula slide spines and on-image text rules

Optional illustration

Offer a generated image when a visual would lift reach. Draft a prompt and call lib.illustrate(prompt, kind="carousel"), pulling brand handle/color from Voice & Brand Profile section 6 for a pixel-exact overlay. Show the returned url + cost, attach it as your Instagram media via media_urls=[url] in one shot (Publora fetches the hosted URL server-side): a single image posts as a photo, and the carousel planner can pass 2-10 URLs for a carousel. For a Reel cover instead, set platformSettings.instagram.coverUrl. Full workflow (incl. quote-cards): ../ig-humanizer/sub-skills/illustration.md. No Pixfaro key -> it drafts the prompt for you to generate manually.

Related skills

  • ig-caption-writer - when the idea is a single image, not a carousel
  • ig-hashtag-strategist - build the sized hashtag set
  • ig-humanizer - scrub the on-image text and caption
  • ig-hook-extractor - reverse-engineer a carousel you admire

FAQ

What does the ig-carousel-planner skill do?

Plan an Instagram carousel slide by slide, up to 10 slides, with a hook slide that opens a loop, value slides that front-load the payoff, and a payoff slide that earns the save and follow. Picks a 2026 carousel formula (listicle, before/after, myth-buster, framework) by goal (saves, shares, follows), drafts each slide's text plus the caption, then publishes the images you supply via Publora. Use to structure a multi-slide carousel. Not for single-image captions (use ig-caption-writer).

How do I install ig-carousel-planner?

Run npx skills add https://github.com/sergebulaev/instagram-skills --skill ig-carousel-planner in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/ig-carousel-planner/ (personal) or .claude/skills/ig-carousel-planner/ (project).

Which AI agents can use ig-carousel-planner?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is ig-carousel-planner safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains ig-carousel-planner?

It is published by sergebulaev in sergebulaev/instagram-skills. It has 54 recorded installs.

More from sergebulaev/instagram-skills

View all →

instagram-marketing

sergebulaev/instagram-skills

Plan, draft, audit, and publish content for Instagram. Use when the user wants to write a caption with a first-125-char hook, plan a slide-by-slide carousel, reverse-engineer the hook from a viral Reel or carousel, size hashtags the 2026 way, remove AI tells from a caption, or plan a week of Reels and carousels. Instagram requires media on every post, so the skills write the caption and the user supplies the image or video; posts publish via the Publora API draft, upload, schedule flow.

Marketing & SEO858 installs

ig-hashtag-strategist

sergebulaev/instagram-skills

Build a sized Instagram hashtag set for a post using the 2026 reality that 3 to 5 well-chosen tags beat 30 random ones. Sizes each tag as niche (under 50k posts), mid (50k to 500k), or broad (500k+), then assembles a 2-3 niche, 1-2 mid, 0-1 broad mix that a small or mid account can actually rank in, matched to the post content and rotated to avoid spam patterns. Use to choose hashtags for a caption, carousel, or Reel. Not for writing the caption itself (use ig-caption-writer).

Docs & Writing51 installs

ig-content-planner

sergebulaev/instagram-skills

Open the skill to read its SKILL.md instructions.

Marketing & SEO49 installs

ig-humanizer

sergebulaev/instagram-skills

Remove the AI tells readers react to in an Instagram caption or carousel slide: 2026 vocabulary by density, reveal bridges, staccato stacks, stacked triads, performed sincerity, emoji storms; caps em dashes. Includes --mode audit (first-125 hook, length, hashtags, emoji, CTA, media) and --mode profile. Not for beating AI detectors (no edit reliably does). Not for writing from scratch (use ig-caption-writer or ig-carousel-planner). Keywords: humanize, de-AI caption, audit before posting.

Security48 installs

ig-hook-extractor

sergebulaev/instagram-skills

Reverse-engineer the hook from a viral Instagram Reel or carousel, given a URL or a pasted caption. Identifies which of the 10 canonical 2026 formulas it uses (number-first, contrarian, relatable, confession, listicle, before/after, myth-buster, framework, pattern-interrupt Reel, how-I Reel), explains why it worked, names the primary goal, and returns a blank template mapped to your topic. Use to learn from a post you admire. Not for writing your own (use ig-caption-writer or ig-carousel-planner).

Docs & Writing47 installs

ig-caption-writer

sergebulaev/instagram-skills

Open the skill to read its SKILL.md instructions.

Docs & Writing46 installs

Popular docs & writing skills

View category →

grill-with-docs

mattpocock/skills

A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.

Docs & Writing1.2M installs

lark-markdown

open.feishu.cn

飞书 Markdown:查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。

Docs & Writing778.7K installs

writing-beats

mattpocock/skills

Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.

Docs & Writing490.7K installs

writing-shape

mattpocock/skills

Writing, exploit: shape raw material into an article, paragraph by paragraph.

Docs & Writing490.2K installs

writing-fragments

mattpocock/skills

Writing, explore: mine raw fragments, no structure yet.

Docs & Writing489.6K installs

writing-for-agents

mattpocock/skills

Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.

Docs & Writing479.3K installs