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.
Badge for your README
Markdown
[](/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
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.
- ---
- 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.
- ---
- # 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.
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.
- # threads-carousel-claude-skill
- A [Claude Code](https://claude.com/claude-code) skill that converts text posts into visual carousel images for **Threads, Instagram, LinkedIn, TikTok, and Stories**.
- 
- 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.
- ## Features
- - **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
- - **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)
- - **4-axis style system** — pick font × surface × accent × purpose independently:
- - **Font (5):** Minimal (Unbounded), Editorial (Playfair), Clean (Inter), Mono (JetBrains Mono), Condensed (Oswald)
- - **Surface (8):** Dark, White, Light, Paper, Gradient, Pastel, Neon, Ember — background + text neutrals
- - **Accent (11):** Yellow, Red, Teal, Coral, Orange, Violet, Lime, Blue, Fuchsia, Pink, Amber — the pop color for highlighted words
- - **Purpose:** Carousel (bold 44px uppercase titles) or Presentation (72px sentence case, lighter body)
- - Total: 5 × 8 × 11 × 2 = **880 valid style combinations**
- - **8 background decorations** — none, organic blobs, dot grid, diagonal lines, **ruled paper** (notebook lines with margin), SVG noise, big number watermark, radial glow
- - **Highlighted keywords** — any word in title or body colored in the accent color, with optional `italic-box` style (Playfair italic on a colored rectangle)
- - **Image support** — drop PNG/JPG files into `template/public/images/` and reference via `imageSrc: "/images/file.png"` in any `image` slide
- - **Badges** — small outlined tags above titles (`01`, `02`, `TIP`, `NEW`)
- - **Text balance** — `text-wrap: balance` on hooks and titles to prevent orphan words
- - **Adaptive typography** — font size scales to content length
- - **Modular architecture** — content in `src/slides.ts`, engine in `src/app/CarouselApp.tsx` + `src/lib/`
- - **Live preview toolbar** — switch format, purpose, font, surface, accent, and background in the browser without editing code
- - **RU/EN toolbar** — UI labels toggle between Russian and English
- - **PNG export** — download individual slides or all at once via `html-to-image`
- - **PDF export** — all slides in a single file via jsPDF (JPEG-compressed, ~5–8 MB for 10 slides)
- ## Quick start
- ### As a Claude Code skill
- 1. Clone the repo into your Claude skills directory:
- ```bash
- 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):
- ```bash
- 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:
- ```bash
- 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
- ```
- ## Architecture
- ```
- template/
- ├── public/
- │ └── images/ ← 📷 Drop PNG/JPG here for `image` slide type
- ├── src/
- │ ├── slides.ts ← ✏️ Edit this: your SLIDES array + defaults
- │ ├── lib/
- │ │ ├── types.ts ← Shared type definitions
- │ │ └── presets.ts ← FONT_STYLES + SURFACES + ACCENTS + composePreset + FORMAT_PRESETS
- │ └── app/
- │ ├── CarouselApp.tsx ← Rendering engine (all slide components + toolbar)
- │ ├── page.tsx ← Dynamic client-only wrapper around CarouselApp
- │ ├── layout.tsx ← Next.js root layout + font loading
- │ └── globals.css ← Minimal global styles + toolbar transitions
- ├── package.json ← Dependencies (Next.js, React, html-to-image, jspdf)
- ├── tsconfig.json
- ├── next.config.ts
- └── postcss.config.mjs
- ```
- **The golden rule:** to change carousel content, only touch `src/slides.ts`. Everything else is the engine.
- ## Slide types reference
- Each slide is an object in the `SLIDES` array with a `type` field and type-specific fields:
- ```ts
- // hook — opening slide
- { type: "hook", text: "Claude Code\nis smarter with skills", highlight: "skills" }
- // body — title + paragraph
- { type: "body", badge: "01", title: "Title", text: "Body text", highlight: "key" }
- // body with points — pros/cons list with ✓/✗ SVG icons
- { type: "body", badge: "03", title: "Pros & Cons", points: [
- { type: "plus", text: "One click to register" },
- { type: "plus", text: "Works on any background" },
- { type: "minus", text: "Requires provider setup" },
- ]}
- // list — numbered items
- { type: "list", title: "Steps", items: ["First", "Second", "Third"] }
- // stats — big numbers
- { type: "stats", title: "Impact", stats: [
- { value: "3×", label: "More saves" },
- { value: "40%", label: "Faster" },
- ]}
- // quote — pulled quote
- { type: "quote", text: "Quote text", author: "Someone", role: "2026" }
- // checklist — checkmarks
- { type: "checklist", title: "Pre-flight", items: ["One", "Two", "Three"] }
- // process — numbered steps with connector
- { type: "process", title: "How it works", steps: [
- { title: "Step 1", text: "Description" },
- { title: "Step 2", text: "Description" },
- ]}
- // comparison — two-column VS
- { type: "comparison", title: "Before vs after",
- leftLabel: "Before", leftItems: ["Slow", "Manual"],
- rightLabel: "After", rightItems: ["Fast", "Automated"],
- }
- // cta — final call to action
- { type: "cta", text: "Follow for more", handle: "@username" }
- // image — text + photo/screenshot (file in template/public/images/)
- { type: "image", badge: "02", title: "GitHub Trending",
- imageSrc: "/images/screenshot.png",
- imageCaption: "source: github.com/trending" }
- // emoji — giant 360px emoji illustration + title + text
- { type: "emoji", emoji: "🚀", title: "Ship it", text: "Done beats perfect." }
- // number — hero digit/string (up to 560px, auto-scales) + title + text
- { type: "number", bigNumber: "88", title: "color combos",
- text: "8 surfaces × 11 accents — independent axes." }
- ```
- ### Italic-box highlight style
- Any slide with a `highlight` field can opt into a stylized highlight — Playfair italic on a colored rectangle (Karpathy-style):
- ```ts
- { type: "hook", text: "Carousels that\nactually pop",
- highlight: "pop",
- highlightStyle: "italic-box" }
- ```
- ## Defaults
- - **Font:** `minimal` (Unbounded throughout)
- - **Surface:** `dark` (black background, white text)
- - **Accent:** `yellow` (#FACC15 highlighted words)
- - **Purpose:** `carousel` (bold 44px uppercase titles with divider)
- - **Background:** `glow` (soft radial gradient in alternating corners)
- - **Format:** `threads-4x5` (1080×1350)
- - **Padding:** 80px, left-aligned
- 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"`.
- **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).
- ## Design system
- 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).
- | Element | Size | Weight | Font axis |
- |---|---|---|---|
- | Hook | 88–170px (adaptive) | 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` |
- | Quote | 62px | 600 | `fontFamily` |
- | List item | 46px | 600 | `fontFamily` |
- | Handle | 36px | 500 | `fontFamily` |
- | Emoji hero | 360px | — | OS emoji font |
- | Big number | 320–560px (auto) | 900 | `hookFontFamily` ?? `fontFamily` |
- | Image caption | 40px | 500 | `fontFamily` |
- ## Tech stack
- - **Next.js 15** — React framework + `next/font/google` for font loading
- - **React 19** — rendering
- - **TypeScript 5** — type safety
- - **Tailwind CSS 4** — minimal usage (mostly for reset)
- - **html-to-image** — client-side PNG / JPEG export
- - **jspdf** — multi-slide PDF export (dynamic import to avoid Next.js 15 webpack ESM issue)
- - **Unbounded** + **Inter** + **Playfair Display** + **JetBrains Mono** + **Oswald** + **Space Grotesk** — via Google Fonts
- ## Customization
- ### Adding a new font
- Add an entry to `FONT_STYLES` in `src/lib/presets.ts` and extend the `FontId` union in `src/lib/types.ts`:
- ```ts
- brand: {
- id: "brand",
- name: "Brand",
- fontFamily: "var(--font-your-font)", // applied to titles, body, badges, stats, handles
- hookFontFamily: "var(--font-your-display)", // optional, hook-only display font
- },
- ```
- ### Adding a new surface
- Add an entry to `SURFACES` and extend the `SurfaceId` union in `src/lib/types.ts`:
- ```ts
- midnight: {
- id: "midnight",
- name: "Midnight",
- bg: "#0A0A1F",
- bgGradient: undefined, // optional CSS gradient (overrides bg)
- textColor: "#E0E7FF",
- textSecondary: "rgba(224,231,255,0.5)",
- accentColor: "#E0E7FF", // titles, dividers, decorative elements
- },
- ```
- ### Adding a new accent
- Add an entry to `ACCENTS` and extend the `AccentId` union:
- ```ts
- rose: { id: "rose", name: "Rose", color: "#F43F5E" },
- ```
- Available font CSS variables (already loaded via Google Fonts):
- - `--font-unbounded` — geometric display, bold
- - `--font-space-grotesk` — modern grotesque
- - `--font-inter` — neutral sans-serif
- - `--font-playfair` — classic serif
- - `--font-jetbrains-mono` — monospace, tech feel
- - `--font-oswald` — narrow condensed, poster feel
- 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()`.
- 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.
- ### Modifying format presets
- Add a new entry to `FORMAT_PRESETS` in `src/lib/presets.ts` and update the `FormatId` union type in `src/lib/types.ts`.
- ## Roadmap
- - [x] **Runtime format switcher** — in the toolbar, resizes canvas live (shipped in [#1](https://github.com/itchernetski/threads-carousel-claude-skill/pull/1)).
- - [x] **PDF export** — all slides in a single file via jsPDF (shipped in [#1](https://github.com/itchernetski/threads-carousel-claude-skill/pull/1)).
- - [x] **Image / emoji / number slide types** — shipped in [v1.2.0](https://github.com/itchernetski/threads-carousel-claude-skill/releases/tag/v1.2.0).
- - [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).
- - [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).
- - [ ] **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.
- - [ ] **Per-slide background override** — different bg type per slide.
- - [ ] **Cyrillic-optimized defaults** — adjust adaptive sizing thresholds for Russian/Cyrillic text density.
- ## Feedback
- Feature requests and ideas: [Telegram discussion](https://t.me/beyondcoinkeeper/170)
- ## Related projects
- - [Slashgear/linkedin-carousel-gen](https://github.com/Slashgear/linkedin-carousel-gen) — LinkedIn carousels via Satori + PDF (TypeScript + Bun)
- - [FranciscoMoretti/carousel-generator](https://github.com/FranciscoMoretti/carousel-generator) — in-browser LinkedIn carousel editor
- - [PritishMishraa/thread-to-carousel](https://github.com/PritishMishraa/thread-to-carousel) — Twitter thread → LinkedIn carousel
- - [fern-opensource/carouselmaker](https://github.com/fern-opensource/carouselmaker) — LinkedIn carousels via LangGraph + Claude + Figma MCP
- ## Contributors
- Thanks to everyone who shipped improvements:
- - [@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))
- ## License
- MIT — see [LICENSE](LICENSE).
- ---
- Built with [Claude Code](https://claude.com/claude-code).
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.