Modo
Agendar llamada

threads-carousel: convertir un texto en carrusel

Convierte un post de texto en las imágenes de un carrusel (o en una presentación) listas para subir, con 12 tipos de lámina, 6 formatos y exportación a PNG o PDF.

threads-carousel: convertir un texto en carrusel
Qué es
threads-carousel es una skill de Ilya Chernetskiy (licencia MIT) que convierte un post de texto en las láminas de un carrusel para Instagram, Threads, LinkedIn o TikTok, con plantillas, 640 estilos y exportación a PNG o PDF.
Qué le das
El texto del post (pegado o en un archivo), la cantidad de láminas, el formato de la red y tu usuario para el cierre
Qué te devuelve
Una vista previa editable en el navegador y las láminas exportadas en PNG o en un solo PDF
Licencia
MIT
En GitHub
124 estrellas · repositorio actualizado el
Revisada por Claura

Funciona en

Claude CodeEn ~/.claude/skills/
CursorEn ~/.agents/skills/
CodexEn ~/.agents/skills/

Con la skill instalada, copia uno y pégaselo a tu agente tal cual, o cambia los datos por los tuyos.

  • Convierte este post de texto en un carrusel de 7 láminas en formato 4:5 para Instagram, con mi usuario en la última: [pega el post].

  • Arma con este hilo de Threads un carrusel para LinkedIn y expórtalo en PDF: [pega el hilo].

  • Haz un carrusel de 5 láminas con los tres consejos de este texto, uno por lámina, y una portada con el gancho.

#Qué hace

threads-carousel es una skill de Ilya Chernetskiy (licencia MIT) que convierte un post de texto en un set de láminas visuales para Threads, Instagram, LinkedIn, TikTok, historias o una presentación. No es una plantilla de Canva: trae su propio motor de diseño, un proyecto de Next.js que Claude completa con tu contenido y que abres en el navegador para exportar.

Lo que trae:

  • 12 tipos de lámina: gancho, cuerpo con título, pros y contras con íconos, lista numerada, cifras grandes, cita, checklist, pasos, comparación lado a lado, imagen o captura, emoji gigante, número protagonista y cierre con tu usuario.
  • 6 formatos: 4:5 para Threads e Instagram (el de siempre), cuadrado para Instagram y LinkedIn, PDF cuadrado para documentos de LinkedIn, 9:16 para TikTok e historias, y 16:9 para presentaciones o YouTube.
  • Un sistema de estilo en tres ejes (letra, superficie y color de acento, más el modo carrusel o presentación) que da 640 combinaciones, y 8 fondos (liso, cuadrícula, papel rayado, grano, número de marca de agua, entre otros).
  • Reglas para partir el texto: el gancho es la línea más intrigante del post, una idea por lámina con un máximo de 40 palabras y 5 líneas, variar los tipos de lámina para que no sean todas iguales, y cerrar con el pedido y tu usuario.

Antes de generar, Claude te muestra el plan de láminas para que lo apruebes. Después copia la plantilla a una carpeta temporal, carga tus láminas, levanta la vista previa en localhost:3333 y desde ahí exportas todo en PNG (una imagen por lámina) o en un único PDF.

#Cómo aplicarla a tu negocio

Imagina una consultora de recursos humanos en Ciudad de México que escribe en LinkedIn dos veces por semana. Algunos posts de texto funcionan muy bien, pero nunca los pasa a carrusel porque diseñar cada uno le lleva una tarde.

Con threads-carousel el reciclaje queda así:

  1. Elige el post que ya probó. Por ejemplo, «7 preguntas que delatan a un mal candidato en la primera entrevista», que tuvo el doble de comentarios que su promedio.
  2. Se lo pasa a Claude con tres datos: 8 láminas, formato PDF cuadrado para LinkedIn y su usuario para el cierre. Si no tiene preferencia de estilo, dice «elige tú» y la skill usa los valores por defecto.
  3. Aprueba el plan. Lámina 1 de gancho con la frase más fuerte, una lámina de pasos, cinco láminas de lista con una pregunta cada una y un cierre. Si una lámina tiene dos ideas, pide partirla.
  4. Ajusta en la vista previa. Cambia a la superficie blanca con acento azul para que combine con su marca y prueba el fondo de papel rayado.
  5. Exporta dos versiones. El PDF para el documento de LinkedIn y, cambiando el formato a 4:5, los PNG para Instagram.

En media hora tiene el mismo contenido en dos redes, sin diseñadora y sin rehacer el texto. Para más herramientas del tema, mira las skills de Claude para redes sociales y carruseles.

#Cómo instalarla

Es una skill agent-agnostic: el mismo SKILL.md corre en cualquier agente que pueda ejecutar comandos. Como el repositorio entero es la skill (con la carpeta template/ que dibuja las láminas), se instala completo.

  • Con una línea, para cualquier agente: npx skills add itchernetski/threads-carousel-claude-skill -g la deja instalada en todos tus proyectos.
  • A mano: clona el repositorio entero en ~/.claude/skills/threads-carousel para Claude Code, o en ~/.agents/skills/threads-carousel para Cursor, Codex y Gemini CLI (las tres leen esa carpeta). Después entra a la carpeta template y corre bun install (o npm install) una sola vez.
  • App de Claude: comprime la carpeta en un ZIP y súbela desde Customize, Skills, «Upload a skill». Ten en cuenta que la vista previa necesita levantar un servidor local, así que donde mejor anda es en Claude Code.

No pide claves ni servicios pagos. El SKILL.md completo (con la licencia MIT y la fuente) está más abajo.

Skill original de Ilya Chernetskiy (MIT). Fuente: github.com/itchernetski/threads-carousel-claude-skill.

El archivo original está en inglés y va tal cual, sin traducir. Lo de arriba de esta ficha es el resumen en español: qué hace, cómo aplicarla y cómo instalarla.

Leer el archivo (313 líneas)

Threads Carousel Generator

Converts a text post into a set of visual carousel slides for Threads, Instagram, LinkedIn, TikTok, Stories, YouTube, or a standalone presentation deck. Composable design system with three independent style axes (font × color × purpose) and 12 slide types.

Invocation

/threads-carousel <post text>
/threads-carousel path/to/post.md

Format presets (choose target platform)

PresetSizePlatforms
threads-4x5 (default)1080×1350Threads, Instagram feed (portrait)
instagram-square1080×1080Instagram, Facebook, LinkedIn feed
linkedin-square1080×1080LinkedIn document post (PDF)
tiktok-9x161080×1920TikTok Photo Mode, Reels, Shorts
story-9x161080×1920Instagram Stories, Threads Stories
wide-16x91920×1080Presentations, YouTube, desktop decks

Slide types (12)

TypePurposeRequired fields
hookOpening slide — the catchiest linetext
bodyTitle + paragraphtitle, text
body (points)Pros/cons list with ✓/✗ SVG iconstitle, points[] (instead of text)
listNumbered items (ordered list)title, items[]
statsBig numbers with labelstitle, stats[]
quoteLarge pulled quotetext, author
checklistCheckmark bulletstitle, items[]
processNumbered steps with connector linetitle, steps[]
comparisonTwo-column VS / before-afterleftLabel, leftItems[], rightLabel, rightItems[]
ctaFinal call to actiontext, handle
imageTitle + screenshot/photo + optional captionimageSrc, optional title, imageCaption
emojiGiant emoji illustration + title + textemoji, optional title, text
numberHuge hero number/string + title + textbigNumber, optional title, text

points shape: Array<{ type: "plus" | "minus"; text: string }> — green ✓ for plus, muted ✗ for minus. Adaptive sizing (44–62px) based on item count and longest line.

All types also support optional:

  • badge — small outlined tag above title (e.g. "01", "TIP")
  • highlight — a word or phrase within text/title that will be colored in the preset's highlight color (yellow for dark themes)
  • highlightStyle: "italic-box" — renders the highlighted word in Playfair italic on a colored rectangle (instead of plain color)
Images in slides

image slides expect imageSrc as a path served by Next.js under /public/. Workflow when a user gives you a local file:

  1. User drops a file path like /Users/me/Desktop/screenshot.png (or passes a file via the chat).
  2. Copy it into template/public/images/ with a safe, lowercase filename — e.g. cp "$USER_PATH" template/public/images/screenshot.png.
  3. In slides.ts reference it as imageSrc: "/images/screenshot.png" (absolute from /public/).

Same-origin serving avoids CORS errors in the PNG export pipeline. Do not use external URLs — html-to-image will often blank them out.

Background decorations (8 types)

Switchable via toolbar in preview. Default: glow.

TypeWhat it is
noneSolid background
blobsOrganic colored shapes
gridDotted grid pattern
linesDiagonal line pattern
paperRuled notebook lines + left margin (use with paper/light/white colors for a literary feel)
noiseSVG grain overlay (overlay blend)
bignumberGiant slide index as watermark (01, 02…)
glow (default)Soft radial gradient in alternating corners

Style system (3 independent axes)

The final style is composed at runtime from three axes via composePreset(font, color, purpose):

Font axis (DEFAULT_FONT), 5 typefaces:

IdFontFeel
minimal (default)Unbounded (body + hook)Geometric display, bold, distinctive
editorialPlayfair DisplayClassic serif, literary
cleanInterNeutral sans-serif, most standard
monoJetBrains MonoMonospace, tech/dev feel
condensedOswaldNarrow + tall, editorial poster

Surface axis (DEFAULT_SURFACE) — bg + text neutrals, 8 options:

IdBgTextFeel
dark (default)#0A0A0Awhitedefault bold
whitepure #FFFFFFnear-blacksharp clinical, Apple-style
lightcool zinc #F4F4F5near-blackneutral cool grey, Vercel-style
papercream #ECE2C8warm brownnotebook / literary warm
gradientpurple→pink→amberwhitebright gradient
pastellilac #EDE9FEindigosoft
neondark gradientlight cyantech dark
emberblack→red radialnear-whitedramatic

Accent axis (DEFAULT_ACCENT) — pop color for highlighted words, 8 options:

IdHexMatches surfaces
yellow (default)#FACC15dark, ember
red#DC2626pure red — white, light, paper
teal#14B8A6versatile — dark, white, light, paper
coral#FB7185pink-family — paper, light, white
orange#F97316pumpkin — paper, light, dark
violet#A78BFAdark, neon, ember
lime#D9F056ember, dark
blue#3B82F6white, light, paper, dark
fuchsia#C026D3pastel, white, dark
pink#EC4899pastel, dark, light
amber#F59E0Bgradient, dark, paper

Total combinations: 8 surfaces × 8 accents × 5 fonts × 2 purposes = 640 valid styles. Pick surface for neutral base, accent for pop color — independently.

Reference combos (inspired by design refs):

  • dark + teal — noir / minimalist tech
  • paper + orange — literary warm
  • ember + lime — dramatic announcement
  • white + coral — sharp editorial
  • light + teal — calm informational

Purpose axis (DEFAULT_PURPOSE):

IdTitleBodyDivider
carousel (default)44px, weight 800, UPPERCASEweight 600, textColor, line-height 1.2visible (96×4px accent)
presentation72px, weight 700, sentence caseweight 400, textSecondary, line-height 1.45hidden

Pick purpose: "presentation" + format: "wide-16x9" for a desktop / YouTube presentation deck. Any 3 × 8 × 2 = 48 combinations are valid.


Workflow

Step 1 — Get the text
  • If passed inline — use it.
  • If a file path (.md, .txt) — read it.
  • If text is long (>500 chars) — confirm it's complete before planning.
Step 2 — Clarify parameters (optional, can assume defaults)

Ask once, combined:

  1. Number of slides (3–10, default 6)
  2. Format (see table above, default threads-4x5; use wide-16x9 for a presentation deck)
  3. Purpose (carousel or presentation, default carousel)
  4. Font (minimal / editorial / clean, default minimal)
  5. Color (8 palettes, default dark)
  6. Handle for CTA slide (e.g. @username)

Shortcut: if user says "presentation" / "презентация" / "slide deck" → default to purpose: presentation, format: wide-16x9, font: clean, color: white.

If user says "your call" — apply defaults, do not block.

Step 3 — Plan the slide breakdown

Show the user a preview list before generation:

Slide 1 (hook): "Headline..."  [highlight: "word"]
Slide 2 (body): badge 01 — "Title" / "Text..."
Slide 3 (list): badge 02 — "iOS stack" / 3 items
Slide 4 (stats): badge 03 — "Growth" / 3 stats
Slide 5 (quote): "Quote..." — Author
Slide 6 (cta): "Final message" @username
Rules for splitting text into slides
  1. Hook = single most intriguing line from the post. 1–3 short lines. Works as a standalone thumbnail.
  2. Body slides = one idea each. Max 40 words. Max 5 lines. Never join two ideas with "and".
  3. Mix slide types for visual variety: prefer list for enumerations, stats for numbers, quote for direct speech, comparison for VS/before-after. Don't make every slide a body.
  4. CTA = conclusion + follow handle. Centered, short.
Step 4 — Generate
Prepare working copy
WORK_DIR="/tmp/carousel-$(date +%s)"
rsync -a --exclude=node_modules ~/.claude/skills/threads-carousel/template/ "$WORK_DIR/"
ln -s ~/.claude/skills/threads-carousel/template/node_modules "$WORK_DIR/node_modules"
cd "$WORK_DIR"

Symlinking node_modules avoids the 350MB copy per run.

Inject content into src/slides.ts

All content + defaults live in src/slides.ts — never touch the engine (src/app/CarouselApp.tsx, src/lib/*). Edit the SLIDES array and the 5 default constants.

Full injection example:

import type { SlideData, BgType, FormatId, FontId, ColorThemeId, PurposeId } from "./lib/types";

export const SLIDES: SlideData[] = [
  { type: "hook", text: "Line one\nline two", highlight: "two" },
  { type: "body", badge: "01", title: "Title", text: "Body text...", highlight: "key" },
  { type: "body", badge: "02", title: "Pros & Cons", points: [
    { type: "plus",  text: "One click to register" },
    { type: "plus",  text: "Works on any background" },
    { type: "minus", text: "Requires provider setup" },
  ]},
  { type: "list", badge: "03", title: "Steps", items: ["First", "Second", "Third"] },
  { type: "stats", title: "Numbers", stats: [
    { value: "10×", label: "Faster" },
    { value: "50%", label: "Smaller" },
  ]},
  { type: "quote", text: "Big idea\nin few words", author: "Someone", role: "2026" },
  { type: "checklist", title: "Pre-flight", items: ["One", "Two", "Three"] },
  { type: "cta", text: "Last word", handle: "@username" },
];

export const DEFAULT_FONT: FontId = "minimal";
export const DEFAULT_COLOR: ColorThemeId = "dark";
export const DEFAULT_PURPOSE: PurposeId = "carousel";
export const DEFAULT_BG: BgType = "glow";
export const DEFAULT_FORMAT: FormatId = "threads-4x5";
Launch preview and export
bun dev --port 3333

Tell the user to open http://localhost:3333. They can:

  • Switch Format / Mode / Font / Color / Background live via toolbar rows
  • Toggle UI language RU / EN in the top-right
  • Click PDF to download all slides in one file (JPEG-compressed, ~5–8 MB for 10 slides)
  • Click PNG (a.k.a. "Export All") to download every slide as 01-hook.png, 02-body.png, …
  • Click an individual slide thumbnail to export just that one as PNG

After export, stop the dev server.

Parallel carousels

If making multiple carousels at once: create multiple work dirs and launch on ports 3333, 3334, 3335 — they run side by side without conflict.


Design system

Canonical look (font: minimal, color: dark, purpose: carousel):

  • Display typeface: Unbounded (Google Fonts), for hooks — applied only when the font axis provides hookFontFamily
  • Body typeface: Space Grotesk (minimal) / Playfair (editorial) / Inter (clean) — everything else uses preset.fontFamily
  • Palette (dark): #0A0A0A bg, #FFFFFF text, #FACC15 highlight
  • Layout: 80px padding, left-aligned, slide counter bottom-center
  • Title discipline: carousel purpose — title → a 96×4px accent divider → body, with ≥64px breathing room above body. Presentation purpose — no divider, sentence case, 72px.
  • Hook size: 104–140px, adaptive by character/line count
  • Body text size: 48–88px, adaptive
  • Text balance: textWrap: "balance" on hook + title (no orphan words)
Typography table (carousel purpose)

The presentation purpose overrides titles to 72px / 700 / sentence case and body to 400 / textSecondary / line-height 1.45.

ElementSizeWeightFont source
Hook104–140px800hookFontFamily ?? fontFamily
Title44px800 uppercasefontFamily
Body48–88px600fontFamily
Points (pros/cons)44–62px600fontFamily
Badge26px800 uppercasefontFamily
Stats value140–170px900fontFamily
Stats label32px500 uppercasefontFamily
Quote62px600fontFamily
List item46px600fontFamily (numbers 48px)
Checklist item44px600fontFamily
Process step title36px700fontFamily
Handle36px500fontFamily

Common mistakes

MistakeFix
Too much text on a slideMax 40 words, max 5 lines
Two ideas on one slideSplit into two slides
All slides are body typeMix in list, stats, quote, checklist for visual variety
No hook on first slideSlide 1 must be the catchiest line
No CTA on last slideSlide N must end with a handle or call to action
Highlight word too longKeep highlight to 1–2 words, not whole phrase
Badge has too many charactersMax 2–4 characters (01, TIP, NEW)

Future work / TODOs

  • Satori server-side export — replace browser-based html-to-image with Satori + Resvg for CLI export (bun run export → out/*.png). Enables headless runs. See Slashgear/linkedin-carousel-gen for reference.
  • Per-slide background override — currently DEFAULT_BG is global; could accept a per-slide bg field to mix decorations across a deck.
  • Cyrillic-optimized adaptive sizing — current thresholds are calibrated for Latin; Russian copy tends to be 20–30% longer at the same font size.
  • Pencil MCP mode — previous skill version had a manual design mode via Pencil; not currently implemented in the template.
Copiar el archivo tal cual
---
name: threads-carousel
user_invocable: true
description: >
  Convert text posts into visual carousel images or presentations for Threads, Instagram, LinkedIn, TikTok, YouTube.
  12 slide types (incl. image/emoji/number), 6 format presets (incl. 1920×1080 wide), 8 background styles (incl. ruled paper), 3-axis style system (font × color × purpose), highlighted keywords with optional italic-box style.
  Generates PNG or single-file PDF via Next.js preview + browser export. RU/EN toolbar.
  Triggers: threads carousel, instagram carousel, linkedin carousel, tiktok carousel, карусель, slides, carousel images, presentation deck, presentation pdf.
---

<!--
Skill original: threads-carousel, de Ilya Chernetskiy (https://github.com/itchernetski/threads-carousel-claude-skill)
Licencia: MIT. Reproducida con atribución según los términos de la licencia.
Copia publicada en claura-ai.com/skills.
-->

# Threads Carousel Generator

Converts a text post into a set of visual carousel slides for Threads, Instagram, LinkedIn, TikTok, Stories, YouTube, or a standalone presentation deck. Composable design system with three independent style axes (font × color × purpose) and 12 slide types.

## Invocation

```
/threads-carousel <post text>
/threads-carousel path/to/post.md
```

## Format presets (choose target platform)

| Preset | Size | Platforms |
|---|---|---|
| `threads-4x5` *(default)* | 1080×1350 | Threads, Instagram feed (portrait) |
| `instagram-square` | 1080×1080 | Instagram, Facebook, LinkedIn feed |
| `linkedin-square` | 1080×1080 | LinkedIn document post (PDF) |
| `tiktok-9x16` | 1080×1920 | TikTok Photo Mode, Reels, Shorts |
| `story-9x16` | 1080×1920 | Instagram Stories, Threads Stories |
| `wide-16x9` | 1920×1080 | Presentations, YouTube, desktop decks |

## Slide types (12)

| Type | Purpose | Required fields |
|---|---|---|
| `hook` | Opening slide — the catchiest line | `text` |
| `body` | Title + paragraph | `title`, `text` |
| `body` (points) | Pros/cons list with ✓/✗ SVG icons | `title`, `points[]` (instead of `text`) |
| `list` | Numbered items (ordered list) | `title`, `items[]` |
| `stats` | Big numbers with labels | `title`, `stats[]` |
| `quote` | Large pulled quote | `text`, `author` |
| `checklist` | Checkmark bullets | `title`, `items[]` |
| `process` | Numbered steps with connector line | `title`, `steps[]` |
| `comparison` | Two-column VS / before-after | `leftLabel`, `leftItems[]`, `rightLabel`, `rightItems[]` |
| `cta` | Final call to action | `text`, `handle` |
| `image` | Title + screenshot/photo + optional caption | `imageSrc`, optional `title`, `imageCaption` |
| `emoji` | Giant emoji illustration + title + text | `emoji`, optional `title`, `text` |
| `number` | Huge hero number/string + title + text | `bigNumber`, optional `title`, `text` |

`points` shape: `Array<{ type: "plus" | "minus"; text: string }>` — green ✓ for plus, muted ✗ for minus. Adaptive sizing (44–62px) based on item count and longest line.

All types also support optional:
- `badge` — small outlined tag above title (e.g. `"01"`, `"TIP"`)
- `highlight` — a word or phrase within `text`/`title` that will be colored in the preset's highlight color (yellow for dark themes)
- `highlightStyle: "italic-box"` — renders the highlighted word in Playfair italic on a colored rectangle (instead of plain color)

### Images in slides

`image` slides expect `imageSrc` as a path served by Next.js under `/public/`. Workflow when a user gives you a local file:

1. User drops a file path like `/Users/me/Desktop/screenshot.png` (or passes a file via the chat).
2. Copy it into `template/public/images/` with a safe, lowercase filename — e.g. `cp "$USER_PATH" template/public/images/screenshot.png`.
3. In `slides.ts` reference it as `imageSrc: "/images/screenshot.png"` (absolute from `/public/`).

Same-origin serving avoids CORS errors in the PNG export pipeline. Do not use external URLs — `html-to-image` will often blank them out.

## Background decorations (8 types)

Switchable via toolbar in preview. Default: `glow`.

| Type | What it is |
|---|---|
| `none` | Solid background |
| `blobs` | Organic colored shapes |
| `grid` | Dotted grid pattern |
| `lines` | Diagonal line pattern |
| `paper` | Ruled notebook lines + left margin (use with `paper`/`light`/`white` colors for a literary feel) |
| `noise` | SVG grain overlay (overlay blend) |
| `bignumber` | Giant slide index as watermark (01, 02…) |
| `glow` *(default)* | Soft radial gradient in alternating corners |

## Style system (3 independent axes)

The final style is composed at runtime from three axes via `composePreset(font, color, purpose)`:

**Font axis** (`DEFAULT_FONT`), 5 typefaces:

| Id | Font | Feel |
|---|---|---|
| `minimal` *(default)* | Unbounded (body + hook) | Geometric display, bold, distinctive |
| `editorial` | Playfair Display | Classic serif, literary |
| `clean` | Inter | Neutral sans-serif, most standard |
| `mono` | JetBrains Mono | Monospace, tech/dev feel |
| `condensed` | Oswald | Narrow + tall, editorial poster |

**Surface axis** (`DEFAULT_SURFACE`) — bg + text neutrals, 8 options:

| Id | Bg | Text | Feel |
|---|---|---|---|
| `dark` *(default)* | `#0A0A0A` | white | default bold |
| `white` | pure `#FFFFFF` | near-black | sharp clinical, Apple-style |
| `light` | cool zinc `#F4F4F5` | near-black | neutral cool grey, Vercel-style |
| `paper` | cream `#ECE2C8` | warm brown | notebook / literary warm |
| `gradient` | purple→pink→amber | white | bright gradient |
| `pastel` | lilac `#EDE9FE` | indigo | soft |
| `neon` | dark gradient | light cyan | tech dark |
| `ember` | black→red radial | near-white | dramatic |

**Accent axis** (`DEFAULT_ACCENT`) — pop color for highlighted words, 8 options:

| Id | Hex | Matches surfaces |
|---|---|---|
| `yellow` *(default)* | `#FACC15` | dark, ember |
| `red` | `#DC2626` | pure red — white, light, paper |
| `teal` | `#14B8A6` | versatile — dark, white, light, paper |
| `coral` | `#FB7185` | pink-family — paper, light, white |
| `orange` | `#F97316` | pumpkin — paper, light, dark |
| `violet` | `#A78BFA` | dark, neon, ember |
| `lime` | `#D9F056` | ember, dark |
| `blue` | `#3B82F6` | white, light, paper, dark |
| `fuchsia` | `#C026D3` | pastel, white, dark |
| `pink` | `#EC4899` | pastel, dark, light |
| `amber` | `#F59E0B` | gradient, dark, paper |

Total combinations: 8 surfaces × 8 accents × 5 fonts × 2 purposes = **640 valid styles**. Pick surface for neutral base, accent for pop color — independently.

**Reference combos** (inspired by design refs):
- `dark + teal` — noir / minimalist tech
- `paper + orange` — literary warm
- `ember + lime` — dramatic announcement
- `white + coral` — sharp editorial
- `light + teal` — calm informational

**Purpose axis** (`DEFAULT_PURPOSE`):

| Id | Title | Body | Divider |
|---|---|---|---|
| `carousel` *(default)* | 44px, weight 800, UPPERCASE | weight 600, `textColor`, line-height 1.2 | visible (96×4px accent) |
| `presentation` | 72px, weight 700, sentence case | weight 400, `textSecondary`, line-height 1.45 | hidden |

Pick `purpose: "presentation"` + `format: "wide-16x9"` for a desktop / YouTube presentation deck. Any 3 × 8 × 2 = 48 combinations are valid.

---

## Workflow

### Step 1 — Get the text

- If passed inline — use it.
- If a file path (`.md`, `.txt`) — read it.
- If text is long (>500 chars) — confirm it's complete before planning.

### Step 2 — Clarify parameters (optional, can assume defaults)

Ask once, combined:

1. **Number of slides** (3–10, default 6)
2. **Format** (see table above, default `threads-4x5`; use `wide-16x9` for a presentation deck)
3. **Purpose** (`carousel` or `presentation`, default `carousel`)
4. **Font** (`minimal` / `editorial` / `clean`, default `minimal`)
5. **Color** (8 palettes, default `dark`)
6. **Handle** for CTA slide (e.g. `@username`)

Shortcut: if user says "presentation" / "презентация" / "slide deck" → default to `purpose: presentation`, `format: wide-16x9`, `font: clean`, `color: white`.

If user says "your call" — apply defaults, do not block.

### Step 3 — Plan the slide breakdown

Show the user a preview list before generation:

```
Slide 1 (hook): "Headline..."  [highlight: "word"]
Slide 2 (body): badge 01 — "Title" / "Text..."
Slide 3 (list): badge 02 — "iOS stack" / 3 items
Slide 4 (stats): badge 03 — "Growth" / 3 stats
Slide 5 (quote): "Quote..." — Author
Slide 6 (cta): "Final message" @username
```

### Rules for splitting text into slides

1. **Hook** = single most intriguing line from the post. 1–3 short lines. Works as a standalone thumbnail.
2. **Body slides** = one idea each. Max 40 words. Max 5 lines. Never join two ideas with "and".
3. **Mix slide types** for visual variety: prefer `list` for enumerations, `stats` for numbers, `quote` for direct speech, `comparison` for VS/before-after. Don't make every slide a `body`.
4. **CTA** = conclusion + follow handle. Centered, short.

### Step 4 — Generate

#### Prepare working copy

```bash
WORK_DIR="/tmp/carousel-$(date +%s)"
rsync -a --exclude=node_modules ~/.claude/skills/threads-carousel/template/ "$WORK_DIR/"
ln -s ~/.claude/skills/threads-carousel/template/node_modules "$WORK_DIR/node_modules"
cd "$WORK_DIR"
```

Symlinking `node_modules` avoids the 350MB copy per run.

#### Inject content into `src/slides.ts`

All content + defaults live in `src/slides.ts` — never touch the engine (`src/app/CarouselApp.tsx`, `src/lib/*`). Edit the `SLIDES` array and the 5 default constants.

Full injection example:

```ts
import type { SlideData, BgType, FormatId, FontId, ColorThemeId, PurposeId } from "./lib/types";

export const SLIDES: SlideData[] = [
  { type: "hook", text: "Line one\nline two", highlight: "two" },
  { type: "body", badge: "01", title: "Title", text: "Body text...", highlight: "key" },
  { type: "body", badge: "02", title: "Pros & Cons", points: [
    { type: "plus",  text: "One click to register" },
    { type: "plus",  text: "Works on any background" },
    { type: "minus", text: "Requires provider setup" },
  ]},
  { type: "list", badge: "03", title: "Steps", items: ["First", "Second", "Third"] },
  { type: "stats", title: "Numbers", stats: [
    { value: "10×", label: "Faster" },
    { value: "50%", label: "Smaller" },
  ]},
  { type: "quote", text: "Big idea\nin few words", author: "Someone", role: "2026" },
  { type: "checklist", title: "Pre-flight", items: ["One", "Two", "Three"] },
  { type: "cta", text: "Last word", handle: "@username" },
];

export const DEFAULT_FONT: FontId = "minimal";
export const DEFAULT_COLOR: ColorThemeId = "dark";
export const DEFAULT_PURPOSE: PurposeId = "carousel";
export const DEFAULT_BG: BgType = "glow";
export const DEFAULT_FORMAT: FormatId = "threads-4x5";
```

#### Launch preview and export

```bash
bun dev --port 3333
```

Tell the user to open `http://localhost:3333`. They can:
- Switch **Format / Mode / Font / Color / Background** live via toolbar rows
- Toggle UI language **RU / EN** in the top-right
- Click **PDF** to download all slides in one file (JPEG-compressed, ~5–8 MB for 10 slides)
- Click **PNG** (a.k.a. "Export All") to download every slide as `01-hook.png`, `02-body.png`, …
- Click an individual slide thumbnail to export just that one as PNG

After export, stop the dev server.

#### Parallel carousels

If making multiple carousels at once: create multiple work dirs and launch on ports 3333, 3334, 3335 — they run side by side without conflict.

---

## Design system

Canonical look (`font: minimal`, `color: dark`, `purpose: carousel`):

- **Display typeface:** Unbounded (Google Fonts), for hooks — applied only when the font axis provides `hookFontFamily`
- **Body typeface:** Space Grotesk (minimal) / Playfair (editorial) / Inter (clean) — everything else uses `preset.fontFamily`
- **Palette (dark):** `#0A0A0A` bg, `#FFFFFF` text, `#FACC15` highlight
- **Layout:** 80px padding, left-aligned, slide counter bottom-center
- **Title discipline:** carousel purpose — title → a 96×4px accent divider → body, with ≥64px breathing room above body. Presentation purpose — no divider, sentence case, 72px.
- **Hook size:** 104–140px, adaptive by character/line count
- **Body text size:** 48–88px, adaptive
- **Text balance:** `textWrap: "balance"` on hook + title (no orphan words)

### Typography table (carousel purpose)

The `presentation` purpose overrides titles to 72px / 700 / sentence case and body to 400 / `textSecondary` / line-height 1.45.

| Element | Size | Weight | Font source |
|---|---|---|---|
| Hook | 104–140px | 800 | `hookFontFamily` ?? `fontFamily` |
| Title | 44px | 800 uppercase | `fontFamily` |
| Body | 48–88px | 600 | `fontFamily` |
| Points (pros/cons) | 44–62px | 600 | `fontFamily` |
| Badge | 26px | 800 uppercase | `fontFamily` |
| Stats value | 140–170px | 900 | `fontFamily` |
| Stats label | 32px | 500 uppercase | `fontFamily` |
| Quote | 62px | 600 | `fontFamily` |
| List item | 46px | 600 | `fontFamily` (numbers 48px) |
| Checklist item | 44px | 600 | `fontFamily` |
| Process step title | 36px | 700 | `fontFamily` |
| Handle | 36px | 500 | `fontFamily` |

## Common mistakes

| Mistake | Fix |
|---|---|
| Too much text on a slide | Max 40 words, max 5 lines |
| Two ideas on one slide | Split into two slides |
| All slides are `body` type | Mix in `list`, `stats`, `quote`, `checklist` for visual variety |
| No hook on first slide | Slide 1 must be the catchiest line |
| No CTA on last slide | Slide N must end with a handle or call to action |
| Highlight word too long | Keep highlight to 1–2 words, not whole phrase |
| Badge has too many characters | Max 2–4 characters (`01`, `TIP`, `NEW`) |

## Future work / TODOs

- **Satori server-side export** — replace browser-based `html-to-image` with Satori + Resvg for CLI export (`bun run export → out/*.png`). Enables headless runs. See `Slashgear/linkedin-carousel-gen` for reference.
- **Per-slide background override** — currently `DEFAULT_BG` is global; could accept a per-slide `bg` field to mix decorations across a deck.
- **Cyrillic-optimized adaptive sizing** — current thresholds are calibrated for Latin; Russian copy tends to be 20–30% longer at the same font size.
- **Pencil MCP mode** — previous skill version had a manual design mode via Pencil; not currently implemented in the template.

Preguntas frecuentes sobre la skill threads-carousel

¿Cómo la aplico a mi negocio?

Le pasas un post que ya funcionó en texto, por ejemplo uno de LinkedIn, y le dices cuántas láminas quieres y para qué red. Te muestra primero el plan de láminas para aprobarlo, después arma la vista previa en tu computadora y tú exportas. Sirve para reciclar lo que ya escribiste en carruseles sin abrir un programa de diseño. Para ideas de qué automatizar alrededor, mira 5 formas de automatizar carruseles de Instagram.

¿Qué necesito para usarla y funciona en español?

Necesitas Claude Code (o un agente que corra comandos) y Bun, npm o pnpm, porque la plantilla es un proyecto de Next.js que instala sus dependencias una vez. No pide claves ni servicios pagos: todo corre en tu computadora. Escribe las láminas en el idioma del texto que le das, así que en español funciona. El autor avisa que el ajuste de tamaño de letra está calibrado para textos en inglés, así que revisa las láminas con frases largas.

Más skills de Redes sociales

Redes sociales

ig-carousel-planner: planificar carruseles de Instagram

Planifica un carrusel de Instagram lámina por lámina: elige la fórmula según el objetivo, escribe el texto de cada imagen y el caption, y deja la última lámina lista para que la guarden.

SkillPrincipianteSKILL.md libre
Redes sociales

ig-hook-extractor: descifrar el hook de un viral

Desarma el gancho de un reel o carrusel viral de Instagram: qué fórmula usa, por qué funcionó, qué buscaba y una plantilla en blanco para tu tema.

SkillPrincipianteSKILL.md libre

Para seguir con este tema

Elegí qué cookies usamos