Skip to content
Back to search

threads-carousel

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.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/itchernetski--threads-carousel-claude-skill/badge.svg)](/listings/itchernetski--threads-carousel-claude-skill)

HTML

<a href="/listings/itchernetski--threads-carousel-claude-skill"><img src="/api/listings/itchernetski--threads-carousel-claude-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

As a Claude Code skill

1. Clone the repo into your Claude skills directory:

   mkdir -p ~/.claude/skills
   git clone https://github.com/itchernetski/threads-carousel-claude-skill.git ~/.claude/skills/threads-carousel

2. Install template dependencies (one-time):

   cd ~/.claude/skills/threads-carousel/template
   bun install   # or pnpm / npm

3. In Claude Code, trigger the skill by pasting a post and saying: > Сделай карусель из этого поста > > or: Make a Threads carousel from this text

Claude reads the text, splits it into slides, edits `src/slides.ts` in a temporary working copy of the template, launches `bun dev` on port 3333, and hands you the preview URL.

Standalone (without Claude)

You can also use the template directly as a Next.js carousel generator:

cd template
bun install
# Edit src/slides.ts with your content
bun dev --port 3333
# Open http://localhost:3333
# Click "Export All" to download PNGs

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 306 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. ---
  2. name: threads-carousel
  3. user_invocable: true
  4. description: >
  5. Convert text posts into visual carousel images or presentations for Threads, Instagram, LinkedIn, TikTok, YouTube.
  6. 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.
  7. Generates PNG or single-file PDF via Next.js preview + browser export. RU/EN toolbar.
  8. Triggers: threads carousel, instagram carousel, linkedin carousel, tiktok carousel, карусель, slides, carousel images, presentation deck, presentation pdf.
  9. ---
  10. # Threads Carousel Generator
  11. 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.
  12. ## Invocation
  13. ```
  14. /threads-carousel <post text>
  15. /threads-carousel path/to/post.md
  16. ```
  17. ## Format presets (choose target platform)
  18. | Preset | Size | Platforms |
  19. |---|---|---|
  20. | `threads-4x5` *(default)* | 1080×1350 | Threads, Instagram feed (portrait) |
  21. | `instagram-square` | 1080×1080 | Instagram, Facebook, LinkedIn feed |
  22. | `linkedin-square` | 1080×1080 | LinkedIn document post (PDF) |
  23. | `tiktok-9x16` | 1080×1920 | TikTok Photo Mode, Reels, Shorts |
  24. | `story-9x16` | 1080×1920 | Instagram Stories, Threads Stories |
  25. | `wide-16x9` | 1920×1080 | Presentations, YouTube, desktop decks |
  26. ## Slide types (12)
  27. | Type | Purpose | Required fields |
  28. |---|---|---|
  29. | `hook` | Opening slide — the catchiest line | `text` |
  30. | `body` | Title + paragraph | `title`, `text` |
  31. | `body` (points) | Pros/cons list with ✓/✗ SVG icons | `title`, `points[]` (instead of `text`) |
  32. | `list` | Numbered items (ordered list) | `title`, `items[]` |
  33. | `stats` | Big numbers with labels | `title`, `stats[]` |
  34. | `quote` | Large pulled quote | `text`, `author` |
  35. | `checklist` | Checkmark bullets | `title`, `items[]` |
  36. | `process` | Numbered steps with connector line | `title`, `steps[]` |
  37. | `comparison` | Two-column VS / before-after | `leftLabel`, `leftItems[]`, `rightLabel`, `rightItems[]` |
  38. | `cta` | Final call to action | `text`, `handle` |
  39. | `image` | Title + screenshot/photo + optional caption | `imageSrc`, optional `title`, `imageCaption` |
  40. | `emoji` | Giant emoji illustration + title + text | `emoji`, optional `title`, `text` |
  41. | `number` | Huge hero number/string + title + text | `bigNumber`, optional `title`, `text` |
  42. `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.
  43. All types also support optional:
  44. - `badge` — small outlined tag above title (e.g. `"01"`, `"TIP"`)
  45. - `highlight` — a word or phrase within `text`/`title` that will be colored in the preset's highlight color (yellow for dark themes)
  46. - `highlightStyle: "italic-box"` — renders the highlighted word in Playfair italic on a colored rectangle (instead of plain color)
  47. ### Images in slides
  48. `image` slides expect `imageSrc` as a path served by Next.js under `/public/`. Workflow when a user gives you a local file:
  49. 1. User drops a file path like `/Users/me/Desktop/screenshot.png` (or passes a file via the chat).
  50. 2. Copy it into `template/public/images/` with a safe, lowercase filename — e.g. `cp "$USER_PATH" template/public/images/screenshot.png`.
  51. 3. In `slides.ts` reference it as `imageSrc: "/images/screenshot.png"` (absolute from `/public/`).
  52. Same-origin serving avoids CORS errors in the PNG export pipeline. Do not use external URLs — `html-to-image` will often blank them out.
  53. ## Background decorations (8 types)
  54. Switchable via toolbar in preview. Default: `glow`.
  55. | Type | What it is |
  56. |---|---|
  57. | `none` | Solid background |
  58. | `blobs` | Organic colored shapes |
  59. | `grid` | Dotted grid pattern |
  60. | `lines` | Diagonal line pattern |
  61. | `paper` | Ruled notebook lines + left margin (use with `paper`/`light`/`white` colors for a literary feel) |
  62. | `noise` | SVG grain overlay (overlay blend) |
  63. | `bignumber` | Giant slide index as watermark (01, 02…) |
  64. | `glow` *(default)* | Soft radial gradient in alternating corners |
  65. ## Style system (3 independent axes)
  66. The final style is composed at runtime from three axes via `composePreset(font, color, purpose)`:
  67. **Font axis** (`DEFAULT_FONT`), 5 typefaces:
  68. | Id | Font | Feel |
  69. |---|---|---|
  70. | `minimal` *(default)* | Unbounded (body + hook) | Geometric display, bold, distinctive |
  71. | `editorial` | Playfair Display | Classic serif, literary |
  72. | `clean` | Inter | Neutral sans-serif, most standard |
  73. | `mono` | JetBrains Mono | Monospace, tech/dev feel |
  74. | `condensed` | Oswald | Narrow + tall, editorial poster |
  75. **Surface axis** (`DEFAULT_SURFACE`) — bg + text neutrals, 8 options:
  76. | Id | Bg | Text | Feel |
  77. |---|---|---|---|
  78. | `dark` *(default)* | `#0A0A0A` | white | default bold |
  79. | `white` | pure `#FFFFFF` | near-black | sharp clinical, Apple-style |
  80. | `light` | cool zinc `#F4F4F5` | near-black | neutral cool grey, Vercel-style |
  81. | `paper` | cream `#ECE2C8` | warm brown | notebook / literary warm |
  82. | `gradient` | purple→pink→amber | white | bright gradient |
  83. | `pastel` | lilac `#EDE9FE` | indigo | soft |
  84. | `neon` | dark gradient | light cyan | tech dark |
  85. | `ember` | black→red radial | near-white | dramatic |
  86. **Accent axis** (`DEFAULT_ACCENT`) — pop color for highlighted words, 8 options:
  87. | Id | Hex | Matches surfaces |
  88. |---|---|---|
  89. | `yellow` *(default)* | `#FACC15` | dark, ember |
  90. | `red` | `#DC2626` | pure red — white, light, paper |
  91. | `teal` | `#14B8A6` | versatile — dark, white, light, paper |
  92. | `coral` | `#FB7185` | pink-family — paper, light, white |
  93. | `orange` | `#F97316` | pumpkin — paper, light, dark |
  94. | `violet` | `#A78BFA` | dark, neon, ember |
  95. | `lime` | `#D9F056` | ember, dark |
  96. | `blue` | `#3B82F6` | white, light, paper, dark |
  97. | `fuchsia` | `#C026D3` | pastel, white, dark |
  98. | `pink` | `#EC4899` | pastel, dark, light |
  99. | `amber` | `#F59E0B` | gradient, dark, paper |
  100. Total combinations: 8 surfaces × 8 accents × 5 fonts × 2 purposes = **640 valid styles**. Pick surface for neutral base, accent for pop color — independently.
  101. **Reference combos** (inspired by design refs):
  102. - `dark + teal` — noir / minimalist tech
  103. - `paper + orange` — literary warm
  104. - `ember + lime` — dramatic announcement
  105. - `white + coral` — sharp editorial
  106. - `light + teal` — calm informational
  107. **Purpose axis** (`DEFAULT_PURPOSE`):
  108. | Id | Title | Body | Divider |
  109. |---|---|---|---|
  110. | `carousel` *(default)* | 44px, weight 800, UPPERCASE | weight 600, `textColor`, line-height 1.2 | visible (96×4px accent) |
  111. | `presentation` | 72px, weight 700, sentence case | weight 400, `textSecondary`, line-height 1.45 | hidden |
  112. Pick `purpose: "presentation"` + `format: "wide-16x9"` for a desktop / YouTube presentation deck. Any 3 × 8 × 2 = 48 combinations are valid.
  113. ---
  114. ## Workflow
  115. ### Step 1 — Get the text
  116. - If passed inline — use it.
  117. - If a file path (`.md`, `.txt`) — read it.
  118. - If text is long (>500 chars) — confirm it's complete before planning.
  119. ### Step 2 — Clarify parameters (optional, can assume defaults)
  120. Ask once, combined:
  121. 1. **Number of slides** (3–10, default 6)
  122. 2. **Format** (see table above, default `threads-4x5`; use `wide-16x9` for a presentation deck)
  123. 3. **Purpose** (`carousel` or `presentation`, default `carousel`)
  124. 4. **Font** (`minimal` / `editorial` / `clean`, default `minimal`)
  125. 5. **Color** (8 palettes, default `dark`)
  126. 6. **Handle** for CTA slide (e.g. `@username`)
  127. Shortcut: if user says "presentation" / "презентация" / "slide deck" → default to `purpose: presentation`, `format: wide-16x9`, `font: clean`, `color: white`.
  128. If user says "your call" — apply defaults, do not block.
  129. ### Step 3 — Plan the slide breakdown
  130. Show the user a preview list before generation:
  131. ```
  132. Slide 1 (hook): "Headline..." [highlight: "word"]
  133. Slide 2 (body): badge 01 — "Title" / "Text..."
  134. Slide 3 (list): badge 02 — "iOS stack" / 3 items
  135. Slide 4 (stats): badge 03 — "Growth" / 3 stats
  136. Slide 5 (quote): "Quote..." — Author
  137. Slide 6 (cta): "Final message" @username
  138. ```
  139. ### Rules for splitting text into slides
  140. 1. **Hook** = single most intriguing line from the post. 1–3 short lines. Works as a standalone thumbnail.
  141. 2. **Body slides** = one idea each. Max 40 words. Max 5 lines. Never join two ideas with "and".
  142. 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`.
  143. 4. **CTA** = conclusion + follow handle. Centered, short.
  144. ### Step 4 — Generate
  145. #### Prepare working copy
  146. ```bash
  147. WORK_DIR="/tmp/carousel-$(date +%s)"
  148. rsync -a --exclude=node_modules ~/.claude/skills/threads-carousel/template/ "$WORK_DIR/"
  149. ln -s ~/.claude/skills/threads-carousel/template/node_modules "$WORK_DIR/node_modules"
  150. cd "$WORK_DIR"
  151. ```
  152. Symlinking `node_modules` avoids the 350MB copy per run.
  153. #### Inject content into `src/slides.ts`
  154. 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.
  155. Full injection example:
  156. ```ts
  157. import type { SlideData, BgType, FormatId, FontId, ColorThemeId, PurposeId } from "./lib/types";
  158. export const SLIDES: SlideData[] = [
  159. { type: "hook", text: "Line one\nline two", highlight: "two" },
  160. { type: "body", badge: "01", title: "Title", text: "Body text...", highlight: "key" },
  161. { type: "body", badge: "02", title: "Pros & Cons", points: [
  162. { type: "plus", text: "One click to register" },
  163. { type: "plus", text: "Works on any background" },
  164. { type: "minus", text: "Requires provider setup" },
  165. ]},
  166. { type: "list", badge: "03", title: "Steps", items: ["First", "Second", "Third"] },
  167. { type: "stats", title: "Numbers", stats: [
  168. { value: "10×", label: "Faster" },
  169. { value: "50%", label: "Smaller" },
  170. ]},
  171. { type: "quote", text: "Big idea\nin few words", author: "Someone", role: "2026" },
  172. { type: "checklist", title: "Pre-flight", items: ["One", "Two", "Three"] },
  173. { type: "cta", text: "Last word", handle: "@username" },
  174. ];
  175. export const DEFAULT_FONT: FontId = "minimal";
  176. export const DEFAULT_COLOR: ColorThemeId = "dark";
  177. export const DEFAULT_PURPOSE: PurposeId = "carousel";
  178. export const DEFAULT_BG: BgType = "glow";
  179. export const DEFAULT_FORMAT: FormatId = "threads-4x5";
  180. ```
  181. #### Launch preview and export
  182. ```bash
  183. bun dev --port 3333
  184. ```
  185. Tell the user to open `http://localhost:3333`. They can:
  186. - Switch **Format / Mode / Font / Color / Background** live via toolbar rows
  187. - Toggle UI language **RU / EN** in the top-right
  188. - Click **PDF** to download all slides in one file (JPEG-compressed, ~5–8 MB for 10 slides)
  189. - Click **PNG** (a.k.a. "Export All") to download every slide as `01-hook.png`, `02-body.png`, …
  190. - Click an individual slide thumbnail to export just that one as PNG
  191. After export, stop the dev server.
  192. #### Parallel carousels
  193. If making multiple carousels at once: create multiple work dirs and launch on ports 3333, 3334, 3335 — they run side by side without conflict.
  194. ---
  195. ## Design system
  196. Canonical look (`font: minimal`, `color: dark`, `purpose: carousel`):
  197. - **Display typeface:** Unbounded (Google Fonts), for hooks — applied only when the font axis provides `hookFontFamily`
  198. - **Body typeface:** Space Grotesk (minimal) / Playfair (editorial) / Inter (clean) — everything else uses `preset.fontFamily`
  199. - **Palette (dark):** `#0A0A0A` bg, `#FFFFFF` text, `#FACC15` highlight
  200. - **Layout:** 80px padding, left-aligned, slide counter bottom-center
  201. - **Title discipline:** carousel purpose — title → a 96×4px accent divider → body, with ≥64px breathing room above body. Presentation purpose — no divider, sentence case, 72px.
  202. - **Hook size:** 104–140px, adaptive by character/line count
  203. - **Body text size:** 48–88px, adaptive
  204. - **Text balance:** `textWrap: "balance"` on hook + title (no orphan words)
  205. ### Typography table (carousel purpose)
  206. The `presentation` purpose overrides titles to 72px / 700 / sentence case and body to 400 / `textSecondary` / line-height 1.45.
  207. | Element | Size | Weight | Font source |
  208. |---|---|---|---|
  209. | Hook | 104–140px | 800 | `hookFontFamily` ?? `fontFamily` |
  210. | Title | 44px | 800 uppercase | `fontFamily` |
  211. | Body | 48–88px | 600 | `fontFamily` |
  212. | Points (pros/cons) | 44–62px | 600 | `fontFamily` |
  213. | Badge | 26px | 800 uppercase | `fontFamily` |
  214. | Stats value | 140–170px | 900 | `fontFamily` |
  215. | Stats label | 32px | 500 uppercase | `fontFamily` |
  216. | Quote | 62px | 600 | `fontFamily` |
  217. | List item | 46px | 600 | `fontFamily` (numbers 48px) |
  218. | Checklist item | 44px | 600 | `fontFamily` |
  219. | Process step title | 36px | 700 | `fontFamily` |
  220. | Handle | 36px | 500 | `fontFamily` |
  221. ## Common mistakes
  222. | Mistake | Fix |
  223. |---|---|
  224. | Too much text on a slide | Max 40 words, max 5 lines |
  225. | Two ideas on one slide | Split into two slides |
  226. | All slides are `body` type | Mix in `list`, `stats`, `quote`, `checklist` for visual variety |
  227. | No hook on first slide | Slide 1 must be the catchiest line |
  228. | No CTA on last slide | Slide N must end with a handle or call to action |
  229. | Highlight word too long | Keep highlight to 1–2 words, not whole phrase |
  230. | Badge has too many characters | Max 2–4 characters (`01`, `TIP`, `NEW`) |
  231. ## Future work / TODOs
  232. - **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.
  233. - **Per-slide background override** — currently `DEFAULT_BG` is global; could accept a per-slide `bg` field to mix decorations across a deck.
  234. - **Cyrillic-optimized adaptive sizing** — current thresholds are calibrated for Latin; Russian copy tends to be 20–30% longer at the same font size.
  235. - **Pencil MCP mode** — previous skill version had a manual design mode via Pencil; not currently implemented in the template.
README.md · README · 294 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # threads-carousel-claude-skill
  2. A [Claude Code](https://claude.com/claude-code) skill that converts text posts into visual carousel images for **Threads, Instagram, LinkedIn, TikTok, and Stories**.
  3. ![Preview](preview.png)
  4. Paste a text post (or a Markdown file) into Claude, say "сделай карусель" / "make a carousel", and get a browser preview with exportable PNGs or a single PDF. Composable design system with **four independent style axes**, 12 slide types, 8 background decorations, and multi-platform format presets.
  5. ## Features
  6. - **12 slide types** — hook, body, list, stats, quote, checklist, process, comparison, cta, **image** (text + photo/screenshot), **emoji** (giant illustration), **number** (hero digit) + a `points` variant of body for ✓/✗ pro/con lists with SVG icons
  7. - **6 format presets** — Threads 4:5, Instagram square, LinkedIn document PDF, TikTok 9:16, Stories 9:16, Wide 16:9 (1920×1080 for presentations / YouTube)
  8. - **4-axis style system** — pick font × surface × accent × purpose independently:
  9. - **Font (5):** Minimal (Unbounded), Editorial (Playfair), Clean (Inter), Mono (JetBrains Mono), Condensed (Oswald)
  10. - **Surface (8):** Dark, White, Light, Paper, Gradient, Pastel, Neon, Ember — background + text neutrals
  11. - **Accent (11):** Yellow, Red, Teal, Coral, Orange, Violet, Lime, Blue, Fuchsia, Pink, Amber — the pop color for highlighted words
  12. - **Purpose:** Carousel (bold 44px uppercase titles) or Presentation (72px sentence case, lighter body)
  13. - Total: 5 × 8 × 11 × 2 = **880 valid style combinations**
  14. - **8 background decorations** — none, organic blobs, dot grid, diagonal lines, **ruled paper** (notebook lines with margin), SVG noise, big number watermark, radial glow
  15. - **Highlighted keywords** — any word in title or body colored in the accent color, with optional `italic-box` style (Playfair italic on a colored rectangle)
  16. - **Image support** — drop PNG/JPG files into `template/public/images/` and reference via `imageSrc: "/images/file.png"` in any `image` slide
  17. - **Badges** — small outlined tags above titles (`01`, `02`, `TIP`, `NEW`)
  18. - **Text balance** — `text-wrap: balance` on hooks and titles to prevent orphan words
  19. - **Adaptive typography** — font size scales to content length
  20. - **Modular architecture** — content in `src/slides.ts`, engine in `src/app/CarouselApp.tsx` + `src/lib/`
  21. - **Live preview toolbar** — switch format, purpose, font, surface, accent, and background in the browser without editing code
  22. - **RU/EN toolbar** — UI labels toggle between Russian and English
  23. - **PNG export** — download individual slides or all at once via `html-to-image`
  24. - **PDF export** — all slides in a single file via jsPDF (JPEG-compressed, ~5–8 MB for 10 slides)
  25. ## Quick start
  26. ### As a Claude Code skill
  27. 1. Clone the repo into your Claude skills directory:
  28. ```bash
  29. mkdir -p ~/.claude/skills
  30. git clone https://github.com/itchernetski/threads-carousel-claude-skill.git ~/.claude/skills/threads-carousel
  31. ```
  32. 2. Install template dependencies (one-time):
  33. ```bash
  34. cd ~/.claude/skills/threads-carousel/template
  35. bun install # or pnpm / npm
  36. ```
  37. 3. In Claude Code, trigger the skill by pasting a post and saying:
  38. > Сделай карусель из этого поста
  39. >
  40. > or: Make a Threads carousel from this text
  41. Claude reads the text, splits it into slides, edits `src/slides.ts` in a temporary working copy of the template, launches `bun dev` on port 3333, and hands you the preview URL.
  42. ### Standalone (without Claude)
  43. You can also use the template directly as a Next.js carousel generator:
  44. ```bash
  45. cd template
  46. bun install
  47. # Edit src/slides.ts with your content
  48. bun dev --port 3333
  49. # Open http://localhost:3333
  50. # Click "Export All" to download PNGs
  51. ```
  52. ## Architecture
  53. ```
  54. template/
  55. ├── public/
  56. │ └── images/ ← 📷 Drop PNG/JPG here for `image` slide type
  57. ├── src/
  58. │ ├── slides.ts ← ✏️ Edit this: your SLIDES array + defaults
  59. │ ├── lib/
  60. │ │ ├── types.ts ← Shared type definitions
  61. │ │ └── presets.ts ← FONT_STYLES + SURFACES + ACCENTS + composePreset + FORMAT_PRESETS
  62. │ └── app/
  63. │ ├── CarouselApp.tsx ← Rendering engine (all slide components + toolbar)
  64. │ ├── page.tsx ← Dynamic client-only wrapper around CarouselApp
  65. │ ├── layout.tsx ← Next.js root layout + font loading
  66. │ └── globals.css ← Minimal global styles + toolbar transitions
  67. ├── package.json ← Dependencies (Next.js, React, html-to-image, jspdf)
  68. ├── tsconfig.json
  69. ├── next.config.ts
  70. └── postcss.config.mjs
  71. ```
  72. **The golden rule:** to change carousel content, only touch `src/slides.ts`. Everything else is the engine.
  73. ## Slide types reference
  74. Each slide is an object in the `SLIDES` array with a `type` field and type-specific fields:
  75. ```ts
  76. // hook — opening slide
  77. { type: "hook", text: "Claude Code\nis smarter with skills", highlight: "skills" }
  78. // body — title + paragraph
  79. { type: "body", badge: "01", title: "Title", text: "Body text", highlight: "key" }
  80. // body with points — pros/cons list with ✓/✗ SVG icons
  81. { type: "body", badge: "03", title: "Pros & Cons", points: [
  82. { type: "plus", text: "One click to register" },
  83. { type: "plus", text: "Works on any background" },
  84. { type: "minus", text: "Requires provider setup" },
  85. ]}
  86. // list — numbered items
  87. { type: "list", title: "Steps", items: ["First", "Second", "Third"] }
  88. // stats — big numbers
  89. { type: "stats", title: "Impact", stats: [
  90. { value: "3×", label: "More saves" },
  91. { value: "40%", label: "Faster" },
  92. ]}
  93. // quote — pulled quote
  94. { type: "quote", text: "Quote text", author: "Someone", role: "2026" }
  95. // checklist — checkmarks
  96. { type: "checklist", title: "Pre-flight", items: ["One", "Two", "Three"] }
  97. // process — numbered steps with connector
  98. { type: "process", title: "How it works", steps: [
  99. { title: "Step 1", text: "Description" },
  100. { title: "Step 2", text: "Description" },
  101. ]}
  102. // comparison — two-column VS
  103. { type: "comparison", title: "Before vs after",
  104. leftLabel: "Before", leftItems: ["Slow", "Manual"],
  105. rightLabel: "After", rightItems: ["Fast", "Automated"],
  106. }
  107. // cta — final call to action
  108. { type: "cta", text: "Follow for more", handle: "@username" }
  109. // image — text + photo/screenshot (file in template/public/images/)
  110. { type: "image", badge: "02", title: "GitHub Trending",
  111. imageSrc: "/images/screenshot.png",
  112. imageCaption: "source: github.com/trending" }
  113. // emoji — giant 360px emoji illustration + title + text
  114. { type: "emoji", emoji: "🚀", title: "Ship it", text: "Done beats perfect." }
  115. // number — hero digit/string (up to 560px, auto-scales) + title + text
  116. { type: "number", bigNumber: "88", title: "color combos",
  117. text: "8 surfaces × 11 accents — independent axes." }
  118. ```
  119. ### Italic-box highlight style
  120. Any slide with a `highlight` field can opt into a stylized highlight — Playfair italic on a colored rectangle (Karpathy-style):
  121. ```ts
  122. { type: "hook", text: "Carousels that\nactually pop",
  123. highlight: "pop",
  124. highlightStyle: "italic-box" }
  125. ```
  126. ## Defaults
  127. - **Font:** `minimal` (Unbounded throughout)
  128. - **Surface:** `dark` (black background, white text)
  129. - **Accent:** `yellow` (#FACC15 highlighted words)
  130. - **Purpose:** `carousel` (bold 44px uppercase titles with divider)
  131. - **Background:** `glow` (soft radial gradient in alternating corners)
  132. - **Format:** `threads-4x5` (1080×1350)
  133. - **Padding:** 80px, left-aligned
  134. Change any of these in `src/slides.ts` via `DEFAULT_FONT`, `DEFAULT_SURFACE`, `DEFAULT_ACCENT`, `DEFAULT_PURPOSE`, `DEFAULT_BG`, and `DEFAULT_FORMAT`. For a presentation deck, set `DEFAULT_PURPOSE = "presentation"` and `DEFAULT_FORMAT = "wide-16x9"`.
  135. **Great combos to try:** `dark + teal` (noir tech), `paper + orange` (literary warm), `ember + lime` (dramatic announcement), `white + coral` (sharp editorial), `pastel + fuchsia` (playful), `gradient + amber` (radiant).
  136. ## Design system
  137. Sizes below are for the default `carousel` purpose. The `presentation` purpose overrides titles to 72px / weight 700 / sentence case / no divider, and body to weight 400 / `textSecondary` / line-height 1.45. Fonts follow the active font axis — Unbounded display accents are used only when the font axis provides `hookFontFamily` (Minimal preset).
  138. | Element | Size | Weight | Font axis |
  139. |---|---|---|---|
  140. | Hook | 88–170px (adaptive) | 800 | `hookFontFamily` ?? `fontFamily` |
  141. | Title | 44px | 800 uppercase | `fontFamily` |
  142. | Body | 48–88px | 600 | `fontFamily` |
  143. | Points (pros/cons) | 44–62px | 600 | `fontFamily` |
  144. | Badge | 26px | 800 uppercase | `fontFamily` |
  145. | Stats value | 140–170px | 900 | `fontFamily` |
  146. | Quote | 62px | 600 | `fontFamily` |
  147. | List item | 46px | 600 | `fontFamily` |
  148. | Handle | 36px | 500 | `fontFamily` |
  149. | Emoji hero | 360px | — | OS emoji font |
  150. | Big number | 320–560px (auto) | 900 | `hookFontFamily` ?? `fontFamily` |
  151. | Image caption | 40px | 500 | `fontFamily` |
  152. ## Tech stack
  153. - **Next.js 15** — React framework + `next/font/google` for font loading
  154. - **React 19** — rendering
  155. - **TypeScript 5** — type safety
  156. - **Tailwind CSS 4** — minimal usage (mostly for reset)
  157. - **html-to-image** — client-side PNG / JPEG export
  158. - **jspdf** — multi-slide PDF export (dynamic import to avoid Next.js 15 webpack ESM issue)
  159. - **Unbounded** + **Inter** + **Playfair Display** + **JetBrains Mono** + **Oswald** + **Space Grotesk** — via Google Fonts
  160. ## Customization
  161. ### Adding a new font
  162. Add an entry to `FONT_STYLES` in `src/lib/presets.ts` and extend the `FontId` union in `src/lib/types.ts`:
  163. ```ts
  164. brand: {
  165. id: "brand",
  166. name: "Brand",
  167. fontFamily: "var(--font-your-font)", // applied to titles, body, badges, stats, handles
  168. hookFontFamily: "var(--font-your-display)", // optional, hook-only display font
  169. },
  170. ```
  171. ### Adding a new surface
  172. Add an entry to `SURFACES` and extend the `SurfaceId` union in `src/lib/types.ts`:
  173. ```ts
  174. midnight: {
  175. id: "midnight",
  176. name: "Midnight",
  177. bg: "#0A0A1F",
  178. bgGradient: undefined, // optional CSS gradient (overrides bg)
  179. textColor: "#E0E7FF",
  180. textSecondary: "rgba(224,231,255,0.5)",
  181. accentColor: "#E0E7FF", // titles, dividers, decorative elements
  182. },
  183. ```
  184. ### Adding a new accent
  185. Add an entry to `ACCENTS` and extend the `AccentId` union:
  186. ```ts
  187. rose: { id: "rose", name: "Rose", color: "#F43F5E" },
  188. ```
  189. Available font CSS variables (already loaded via Google Fonts):
  190. - `--font-unbounded` — geometric display, bold
  191. - `--font-space-grotesk` — modern grotesque
  192. - `--font-inter` — neutral sans-serif
  193. - `--font-playfair` — classic serif
  194. - `--font-jetbrains-mono` — monospace, tech feel
  195. - `--font-oswald` — narrow condensed, poster feel
  196. Then set `DEFAULT_FONT` / `DEFAULT_SURFACE` / `DEFAULT_ACCENT` in `src/slides.ts` to your new ids. Font × surface × accent × purpose are composed into a final `StylePreset` at runtime by `composePreset()`.
  197. To add a new font: import it in `src/app/layout.tsx` via `next/font/google`, add a CSS variable, and reference it in a `FONT_STYLES` entry.
  198. ### Modifying format presets
  199. Add a new entry to `FORMAT_PRESETS` in `src/lib/presets.ts` and update the `FormatId` union type in `src/lib/types.ts`.
  200. ## Roadmap
  201. - [x] **Runtime format switcher** — in the toolbar, resizes canvas live (shipped in [#1](https://github.com/itchernetski/threads-carousel-claude-skill/pull/1)).
  202. - [x] **PDF export** — all slides in a single file via jsPDF (shipped in [#1](https://github.com/itchernetski/threads-carousel-claude-skill/pull/1)).
  203. - [x] **Image / emoji / number slide types** — shipped in [v1.2.0](https://github.com/itchernetski/threads-carousel-claude-skill/releases/tag/v1.2.0).
  204. - [x] **Split surface + accent axes** — 88 color combos via independent axes, shipped in [v1.2.0](https://github.com/itchernetski/threads-carousel-claude-skill/releases/tag/v1.2.0).
  205. - [x] **Mono + Condensed fonts + italic-box highlight + ruled-paper bg** — shipped in [v1.2.0](https://github.com/itchernetski/threads-carousel-claude-skill/releases/tag/v1.2.0).
  206. - [ ] **Satori + Resvg server-side export** — replace browser-based `html-to-image` with headless PNG generation for sharper output and CLI use. See [Slashgear/linkedin-carousel-gen](https://github.com/Slashgear/linkedin-carousel-gen) for reference.
  207. - [ ] **Per-slide background override** — different bg type per slide.
  208. - [ ] **Cyrillic-optimized defaults** — adjust adaptive sizing thresholds for Russian/Cyrillic text density.
  209. ## Feedback
  210. Feature requests and ideas: [Telegram discussion](https://t.me/beyondcoinkeeper/170)
  211. ## Related projects
  212. - [Slashgear/linkedin-carousel-gen](https://github.com/Slashgear/linkedin-carousel-gen) — LinkedIn carousels via Satori + PDF (TypeScript + Bun)
  213. - [FranciscoMoretti/carousel-generator](https://github.com/FranciscoMoretti/carousel-generator) — in-browser LinkedIn carousel editor
  214. - [PritishMishraa/thread-to-carousel](https://github.com/PritishMishraa/thread-to-carousel) — Twitter thread → LinkedIn carousel
  215. - [fern-opensource/carouselmaker](https://github.com/fern-opensource/carouselmaker) — LinkedIn carousels via LangGraph + Claude + Figma MCP
  216. ## Contributors
  217. Thanks to everyone who shipped improvements:
  218. - [@azdaev](https://github.com/azdaev) — `points` slide type, 3-axis style system, `wide-16x9` format, PDF export, runtime format switcher, RU/EN toolbar ([#1](https://github.com/itchernetski/threads-carousel-claude-skill/pull/1))
  219. ## License
  220. MIT — see [LICENSE](LICENSE).
  221. ---
  222. Built with [Claude Code](https://claude.com/claude-code).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.