/world-class-carousel

name: world-class-carousel
description: "Generate world-class Instagram carousel content on any topic. Produces 7-10 publication-ready slides (1080x1350) with AI-generated visuals, precise typography, Instagram music recommendations, optimized captions, and hashtags. Uses Aristotelian first-principles framework with 7 content archetypes, 6 hook patterns, a mandatory Bullshit Test quality gate, and a comprehensive design system. Fully generalized -- works for ANY topic. Triggers: instagram carousel, create carousel, carousel post, make carousel slides, instagram slides, carousel content, slide deck for instagram, swipeable post"
allowed-tools: Bash, Read, Edit, Write, Glob, Grep, WebFetch

World-Class Instagram Carousel Generator

Generate Instagram carousels that are genuinely world-class: content people save, share, and come back to. Not engagement bait. Not AI slop. Actual value, delivered through precise visual design and narrative structure.

This skill is **fully generalized**. It contains FORM (structure, principles, patterns), not MATTER (specific topics). The user provides the matter (topic); the skill provides the form (archetypes, design system, music matrix, quality gates). Together they produce the carousel. Nothing is hardcoded.

---

BEFORE YOU START: Read `KNOWN_ISSUES.md`

Before generating ANY carousel, read `/home/node/.claude/skills/world-class-carousel/KNOWN_ISSUES.md`. It contains compressed rules from all previous sessions -- data format gotchas, sizing rules, visual strategy decisions, and quality gates. Ignoring it means repeating solved mistakes.

---

EXECUTION PIPELINE

When the user requests a carousel, execute these 6 phases in order (Phase 6 runs post-delivery):

PHASE 1: RESEARCH & STRUCTURING

1. **Analyze the topic** -- What is the core insight? What specific value can this deliver? 2. **Identify the audience** -- What does the target audience NOT already know? What's their current understanding? 3. **Auto-detect content vertical and theme** -- Use the Content Vertical Detection table below 4. **Select the archetype** -- Which of the 7 carousel archetypes (see below) fits best? Use the Archetype Selection Guide below. Auto-select unless the user specifies. 5. **Design the narrative arc** -- Map each archetype role to a renderer slide type using the Role-to-SlideType Mapping below. Ensure each slide creates a curiosity gap that the next slide resolves. 6. **Run the Bullshit Test on the outline** -- Does every slide pass? (See QUALITY GATE below)

Content Vertical Detection (Topic -> Theme)

Analyze the topic and auto-select the renderer theme:

| Content Vertical | Keywords/Signals | Renderer Theme | Background Style | |-----------------|-----------------|----------------|-----------------| | Tech / AI / Coding | AI, code, developer, API, tools, stack, programming, SaaS, data | `dark` | `gradient` (default) | | Business / Strategy | growth, revenue, startup, founder, marketing, sales, strategy, scale | `earth` | `gradient` | | Education / How-To | learn, tutorial, guide, roadmap, beginner, master, course, how to | `clean` | `gradient` | | Creative / Design | design, UX, brand, visual, aesthetic, portfolio, creative | `dark` | `gradient_mesh` | | Mindset / Philosophy | mindset, habits, productivity, stoic, growth, mental, philosophy | `warm` | `gradient` |

If the user specifies a brand config with a theme, always use that instead.

Content Category Selection (10 Categories, Aristotelian)

Each category has unique visual DNA derived from psychology axioms (Cialdini, cognitive load theory, dual coding, serial position effect). Select based on topic:

| If the topic is about... | Category | Arc Shape | Hook Style | Primary Cialdini | |--------------------------|----------|-----------|------------|------------------| | Explaining a research paper | `paper_decoder` | Revelatory | Face + paper panel | Authority | | Comparing AI tools/models | `tool_showdown` | Divergent | Multi-screenshot face-off | Social Proof | | Today's AI development | `breaking_news` | Convergent | News-editorial face | Scarcity | | Step-by-step AI tool how-to | `tool_tutorial` | Linear | Phone-in-hand / device mockup | Reciprocity | | Controversial opinion | `hot_take` | Confrontational | Bold abstract typography | Authority | | Copy-paste prompts/templates | `prompt_playbook` | Divergent | Phone screenshot mockup | Reciprocity | | Complete sector overview | `industry_map` | Divergent | Multi-person face-off | Authority | | Build [X] with AI project | `build_this` | Linear+Reveal | Multi-device result showcase | Social Proof | | Funding/business news | `founders_money` | Convergent | Founder portrait + data | Scarcity | | Future predictions/timeline | `future_scenario` | Revelatory | Abstract cinematic AI imagery | Scarcity |

**Universal Psychology Rules (apply to ALL categories):**

• Max 4 information chunks per slide (Cognitive Load Theory, Sweller)
• Pattern interrupt every 2-3 slides (diagram, comparison, color shift, or layout change)
• Density wave: H-M-H-M-H-H-M (never 3 high-density slides consecutively)
• Synthesis slide = THE save trigger (Serial Position Effect: last items remembered best)
• Dual-code the hardest concept (Paivio: visual + text = 6.5x retention)
• CTA matches save trigger: utility categories → "Save this", social categories → "Share/Comment"

**Category-to-Slide-Sequence Quick Reference:**

• `paper_decoder` (9 slides): hook → body → **diagram** → body → body → **diagram** → body → synthesis → cta
• `tool_showdown` (8 slides): hook → body → **comparison** → body → body → **comparison** → synthesis → cta
• `breaking_news` (8 slides): hook → body → body → body → **diagram** → body → synthesis → cta
• `tool_tutorial` (8 slides): hook → body → **tool** → **tool** → **tool** → body → synthesis → cta
• `hot_take` (7 slides): hook → body → body → body → body → synthesis → cta (text-driven, no diagrams)
• `prompt_playbook` (9 slides): hook