What is carousel-builder?

This repository is a plugin for Claude Code, the AI coding assistant that runs in your terminal. It adds a command called /carousel that builds a complete, branded Instagram carousel without you leaving the terminal or opening a design tool manually. The workflow connects to two external services: Higgsfield for AI image generation and Canva for assembling the final slides. When you run /carousel and give it a topic, it walks through a structured process. First it reads a reference template so it understands the visual style you want: headline formatting, which words should be highlighted in a different color, and image aesthetics. Then it breaks your topic into four to six pillar points, each one making a single argument or takeaway. It generates cover image options using Higgsfield, you pick one, and that image becomes the visual anchor that all the other images are matched against, so the whole deck looks like it belongs together. Before any images are generated for the slides, the tool writes the copy and checks every line against character budgets. The budgets exist because Canva text boxes have fixed sizes: if your headline is too long, the text overflows and the slide breaks the visual template. The tool enforces these limits at the draft stage, so you approve the copy before any image credits are spent. Once approved, it generates the slide images and then assembles everything in Canva by duplicating your template and swapping in the new text and images. The package also includes a standalone command called /short-form-caption. It writes a short Instagram or TikTok caption from a topic or transcript, with a call to action on the first line, exactly five hashtags, and a 500-character limit. The /carousel command calls this automatically at the end so your post copy and the carousel CTA use the same keyword. Installing it is a single command if you use the Claude Code plugin marketplace. You need a Canva template and accounts with both Higgsfield and Canva to actually run it.