mcpField
C
carousel-generator

carousel-generator

github.com/drshailesh88Marketing & growth640 installsUpdated 24w ago
Repository

About carousel-generator

carousel-generator is a local Python skill that turns text into branded, square Instagram carousel slides. It supports Markdown-style text or JSON input and produces PNG files without requiring API keys.

Key features

  1. 01Generate 1080×1080 slides
  2. 02Apply specified brand colors
  3. 03Add consistent name and handle footer
  4. 04Wrap text and render bullets
  5. 05Support text and JSON input

Use cases

  1. 01Turn an article into Instagram slides
  2. 02Create branded carousel posts for either account
  3. 03Generate slides from structured JSON
  4. 04Export carousel PNGs locally

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/drshailesh88/integrated_content_os --skill carousel-generator

After installing, type/carousel-generatorin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

test-content.txt
knowledge-base/audience/
archetypes.md
knowledge-base/frameworks/
content-frameworks.md
references/
brand-specs.md
input-formats.md
tools/
generate-carousel.py

Details

From the project README

Carousel Generator

Generate branded Instagram carousels (1080x1080px) from text content.

Quick Start

cd "/Users/shaileshsingh/integrated cowriting system/skills/cardiology/carousel-generator"
python tools/generate-carousel.py <input_file> <account> [options]

# Examples:
python tools/generate-carousel.py content.txt 1           # Account 1: @heartdocshailesh
python tools/generate-carousel.py content.txt 2           # Account 2: @dr.shailesh.singh
python tools/generate-carousel.py content.txt 1 -m 8      # Max 8 slides
python tools/generate-carousel.py content.txt 1 -o ~/out  # Custom output dir

Features

  • 1080x1080px Instagram carousel slides
  • Brand colors (Deep Teal, Mist Aqua, Warm Coral)
  • Consistent footer with name and handle
  • Automatic text wrapping
  • Bullet point rendering
  • Title slides (teal background) + content slides (light background)

Input Formats

1. Plain Text with Markdown
# Main Title
Subtitle or intro

---

## Slide 2 Title
• Bullet point 1
• Bullet point 2

---

## Slide 3
Body text with automatic wrapping.
2. JSON Format
[
  {"title": "Title Slide", "body": "Subtitle", "type": "title"},
  {"title": "Content Slide", "body": "Body text", "type": "content"}
]

Output

PNG files in output/carousels/<name>/account-<n>/

Brand Specifications

Colors
COLORS = {
    'primary': '#207178',      # Deep Teal - titles, CTAs
    'secondary': '#E4F1EF',    # Mist Aqua - backgrounds
    'accent': '#F28C81',       # Warm Coral - bullets, highlights
    'neutral_light': '#F8F9FA', # Off-White - alt backgrounds
    'neutral_dark': '#333333',  # Charcoal - body text
    'alert': '#E63946'         # Heart Red - emphasis
}
Accounts
  • Account 1: @heartdocshailesh
  • Account 2: @dr.shailesh.singh
Typography
  • Font: Inter (Bold, SemiBold, Regular, Medium)
  • Fallback: Helvetica (macOS) -> System default

Dependencies

  • Python 3.11+
  • Pillow (PIL) for image generation
  • No API keys required (runs locally)
pip install pillow

Note

This skill is called by the content-os orchestrator for carousel generation. You can also use it standalone for quick carousel creation.

Comments

Markdown supported