carousel

# LinkedIn Carousel Generator (Gamma API) Generate LinkedIn carousel PDFs using the Gamma API. Takes slide content, applies your brand theme, generates AI images, and exports a ready-to-post PDF. ## How to Use ### Step 1: Get the Content Parse `$ARGUMENTS` for one of: - A **topic or concept** to build slides from scratch - A **file path** to an existing carousel outline (e.g. from `/social-copy` or `/yt-shorts`) - A **video slug** to pull carousel content from `~/content/youtube/<slug>/social/` If given a topic, write the slide content yourself. If given a file, read it and adapt. ### Step 2: Write the Slides Create a markdown file with **6 slides** (no CTA slide - you add that separately). Each slide is separated by `\n---\n`. **Slide structure:** - **Slide 1 (Hook):** Bold headline that stops the scroll. Short, punchy, curiosity-driven. - **Slides 2-5 (Value):** One key point per slide. Short paragraphs, bullet points, or numbered steps. Keep text brief - this is a visual format. - **Slide 6 (Summary/Takeaway):** Wrap up with the key insight or actionable takeaway. **Rules for slide text:** - Keep each slide concise - 2-4 short lines max - No hashtags on slides (those go in the LinkedIn post caption) - No em dashes - use commas or hyphens instead - No markdown formatting (bold, italic) - Gamma handles styling - Each slide should stand alone but flow as a story Save the slide content to a temp file or directly in the video package folder. Example format: ``` The #1 Mistake Killing Your AI Workflow Most people use AI like a search engine. Here's how to use it like a system. --- Stop prompting from scratch every time If you've typed the same prompt twice, you're wasting time. Save it. Reuse it. Automate it. --- Build reusable skills A skill is a saved prompt template that runs with one command. /transcribe, /yt-thumbnail, /yt-seo One command. Full workflow. --- Chain skills into pipelines Skills aren't just standalone tools. They compose. Research > Transcribe > Script > SEO > Publish One session. Full video package. --- Start with what you repeat Look at your last week. What did you prompt Claude to do more than once? That's your first skill. --- The system beats the prompt One good skill saves more time than a hundred clever prompts. Build the system. Let AI do the rest. ``` ### Step 3: Choose Settings Ask the user about: **Theme:** Run `--list-themes` first to show available Gamma themes. ```bash python3 ~/.claude/skills/carousel/gamma_carousel.py dummy --list-themes ``` If the user has a preferred theme, use its ID. Otherwise let Gamma pick. **Image model:** - `flux-1-pro` (default, recommended - high quality) - `dalle-3` (alternative) - `flux-1-schnell` (fast, lower quality) **Image style** (optional): Describe the visual style, e.g. "dark moody tech aesthetic", "clean minimal with blue accents", "vibrant gradients" If the user says "defaults" or "just do it", use: flux-1-pro, no specific style, 6 slides. ### Step 4: Generate Save the slide content to a markdown file, then run: ```bash python3 ~/.claude/skills/carousel/gamma_carousel.py "<input_file>" \ [--theme-id "<theme_id>"] \ [--num-cards 6] \ [--image-model flux-1-pro] \ [--image-style "<style_description>"] \ [--output "<output_path>"] ``` The script will: 1. Send the content to Gamma's API 2. Poll every 5 seconds until done 3. Download the PDF to the output path ### Step 5: Present Results After generation: 1. Show the Gamma URL (user can view/edit in browser) 2. Show the PDF path 3. Show credits used 4. Remind the user to add their CTA slide separately (Kie.ai generated) 5. Ask if they want to regenerate with different settings or create another ## Output All carousels save to `~/content/platform/carousels/` regardless of source: - Default: `~/content/platform/carousels/<slug>/<slug>_carousel.pdf` - User can override with `--output` Note: This skill generates **LinkedIn PDF carousels** via Gamma API. For **Instagram visual carousels** with AI backgrounds, use `/carousel-app` instead. ## Rules - Always 6 content slides (no CTA - you add that separately with Kie.ai) - Use `textMode: preserve` so Gamma styles the text but doesn't rewrite it - Use `cardSplit: inputTextBreaks` so `---` separators control slide breaks - Use `4x5` dimensions for LinkedIn carousel format - Keep slide text brief and scannable - No em dashes anywhere - No hashtags on slides - Show the user the slide content before generating - Uses GAMMA_API_KEY from `~/.claude/.env`