Carousel Generator

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.

ICP (Ideal Customer Profile) - Audience Archetypes

Overview

6 distinct audience segments, each with different awareness levels, pain points, and content needs.

---

Archetype 1: Heart Patients (Post-Event)

Demographics

• Age: 45-70
• Just had: Heart attack, stent, bypass, or diagnosis
• Location: Urban/Semi-urban India
• Education: Varied

Psychographics

• Fear: "Will this happen again?"
• Confusion: Conflicting advice from family, internet, other doctors
• Hope: Wanting to believe lifestyle changes work
• Trust issues: Skeptical after medical system experiences

Awareness Level

Solution Aware → Know they need to change, seeking HOW

Content Needs

• Clear medication guidance
• Lifestyle do's and don'ts
• Recovery timelines
• When to worry vs. when to relax
• Success stories of recovery

Trigger Phrases

• "Stent ke baad kya khana chahiye"
• "Heart attack dobara na ho"
• "Bypass surgery recovery"

---

Archetype 2: Lifestyle Disease Group

Demographics

• Age: 35-60
• Conditions: Diabetes, Hypertension, Metabolic Syndrome, Obesity
• Often: Multiple conditions overlapping

Psychographics

• Denial: "It's not that serious yet"
• Overwhelm: Too many things to change
• Medication resistance: "Goli nahi leni, natural chahiye"
• Guilt: Know they should do better

Awareness Level

Problem Aware → Know something's wrong, not sure how serious

Content Needs

• Wake-up calls with data (not fear-mongering)
• Incremental change strategies
• Medication myth-busting
• Connection between conditions (diabetes → heart)
• Practical diet/exercise for Indian lifestyle

Trigger Phrases

• "Sugar control kaise karein"
• "BP ki goli lifetime leni padegi?"
• "Diabetes se heart attack ka connection"

---

Archetype 3: Proactive Biohackers

Demographics

• Age: 30-50
• Profile: High-income, educated professionals
• Interest: Longevity, optimization, prevention

Psychographics

• Data-driven: Want numbers, biomarkers
• Proactive: Prevention over cure
• Skeptical: Question mainstream advice
• Investment mindset: Health as ROI

Awareness Level

Product Aware → Know specific tests/interventions, comparing options

Content Needs

• Advanced biomarkers (ApoB, Lp(a), CAC score)
• Latest research and studies
• Test interpretation
• Supplement evidence review
• Longevity protocols

Trigger Phrases

• "ApoB vs LDL"
• "Lp(a) kya hai"
• "CAC score interpretation"
• "Zone 2 cardio for heart health"

---

Archetype 4: Health Enthusiasts

Demographics

• Age: 25-45
• Profile: Fitness-conscious, some medical knowledge
• Motivation: General wellness, family health

Psychographics

• Curious: Wants to understand why
• Myth-skeptic: Questions viral health claims
• Sharers: Will forward good content to family
• Moderate: Balanced approach, not extreme

Awareness Level

Solution Aware → Knows lifestyle matters, wants evidence-based guidance

Content Needs

• Myth-busting content
• Science explanations made simple
• Practical tips that fit Indian lifestyle
• Family health management
• Exercise and diet evidence

Trigger Phrases

• "Desi ghee heart ke liye theek hai?"
• "Walking vs gym"
• "Best diet for Indians"

---

Archetype 5: Caregivers

Demographics

• Age: 30-55
• Role: Spouse, adult children of heart patients
• Gender: Often women managing family health

Psychographics

• Anxiety: Constant worry about loved one
• Responsibility: Feel they must manage everything
• Information hunger: Want to be prepared
• Guilt: When something goes wrong

Awareness Level

Problem Aware → Know the risk, need actionable guidance

Content Needs

• Warning signs to watch for
• Emergency protocols
• How to support without nagging
• Cooking/diet for heart patients
• Genetic/family risk assessment

Trigger Phrases

• "Heart attack ke symptoms"
• "Papa ko kya khilayein"
• "Family history means kya"

---

Archetype 6: Young & Anxious

Demographics

• Age: 25-40
• Profile: Young professionals, often after health scare or family event
• Trigger: Parent's heart attack, routine test abnormality, viral content

Psychographics

• Health anxiety: Hypochondriac tendencies
• Information overload: Dr. Google syndrome
• Reassurance-seeking: Want to hear "you're fine"
• Prevention-minded: Don't want parents' fate

Awareness Level

Unaware to Problem Aware → May not have real problem, but worried

Content Needs

• When to worry vs. when not to
• Normal vs. abnormal explained
• Early screening recommendations
• Anxiety vs. real symptoms
• Lifestyle for prevention (not treatment)

Trigger Phrases

• "Chest pain at 30"
• "High cholesterol at young age"
• "Should I get tested"
• "Panic attack vs heart attack"

---

Awareness Level Framework

---

Content-Archetype Matrix

---

Engagement Patterns by Archetype

---

Use this profile to tailor hooks, depth, tone, and CTAs for each piece of content.

Content Frameworks

Ship 30 for 30 Framework

4A Categories

Every piece of content should fit one of these categories:

1. Actionable - Practical tips they can use today 2. Analytical - Data-driven insights and research 3. Aspirational - Motivational, showing what's possible 4. Anthropological - Stories and human experiences

10 Magical Ways (Content Modifiers)

View any topic through these 10 lenses:

1. Tips - "5 Tips for..." (Actionable advice) 2. Stats - "The Data Shows..." (Numbers and research) 3. Steps - "How to... in 5 Steps" (Process breakdown) 4. Lessons - "What I Learned..." (Experience insights) 5. Examples - "Case Study:..." (Real scenarios) 6. Reasons - "Why X Matters" (The logic behind) 7. Mistakes - "Avoid These Errors" (Common pitfalls) 8. Questions - "Have You Considered?" (Thought-provoking) 9. Stories - "The Patient Who..." (Narrative) 10. Benefits - "The Results of..." (Outcomes)

Headline Formula

[Number] + [What] + [For Whom] + [Outcome] + [Curiosity]

Examples:

• "5 Heart Attack Signs Every Diabetic Should Know"
• "3 Foods That Actually Lower Cholesterol (Research Says)"
• "Why Statins Failed This Patient (And What Worked)"

Skimmability Rhythms

• 1/3/1 - One point, three supporting bullets, one conclusion
• 1/5/1 - Hook, five main points, CTA
• 3/3/3 - Three sections, three points each, three words per key phrase

---

Cole GPT Method (Mini-Model Technique)

Core Principle

User provides first draft → AI generates 5 variations → User picks best elements → Iterate

90% Value Rule

90% of content value comes from:

• Headline (hook)
• 3 Main Points (structure)

Workflow

1. User writes rough draft or bullet points 2. AI generates 5 headline variations 3. User picks best headline 4. AI generates 5 body variations 5. User picks and combines best elements 6. Final polish

---

Anti-AI Detection Guidelines

AVOID (AI Tells)

• "It's important to note that..."
• "In conclusion" / "In summary"
• "Stands as a testament to..."
• "Plays a vital role in..."
• Excessive em dashes (—) - MAX 1 per paragraph
• Rule of three lists everywhere
• "Groundbreaking", "game-changing", "revolutionary"
• "Nestled", "breathtaking", "vibrant tapestry"
• Starting sentences with "So," or "Well,"

USE (Human Patterns)

• Specific data with actual numbers
• Proper source attribution (journal names)
• Natural, varied sentence lengths
• First-person clinical insights ("In my clinic, I see...")
• Statistics: HR, NNT, CI when available
• Occasional incomplete sentences. Like this.
• Questions to the reader
• Contractions (don't, won't, can't)
• Colloquial transitions ("Look," "Here's the thing," "Thing is,")

Sentence Variation

• Mix short. Medium length sentences work too. And then throw in a longer sentence that develops the idea more fully before concluding with another short one.
• Never more than 2 sentences in a row with same structure
• Vary paragraph lengths (1-5 sentences)

---

YouTube Structure (Hinglish)

Think School Approach

1. Thesis Hook - State the controversial/surprising claim upfront 2. Data as Plot Points - Each data point moves the story forward 3. Logical Flow - Clear cause → effect → implication 4. Strong Conclusion - Tie back to thesis with actionable insight

Neelesh Misra Pacing

1. Empathetic Start - Connect emotionally first 2. Simple Hindustani - Hindi narrative, English for technical terms 3. Strategic Pauses - Let important points sink in 4. Warm Tone - Like talking to a friend

Language Balance

• 70% Hindi (narrative, emotion, flow)
• 30% English (medical terms, data, precision)

Opening Formula

"Dekhiye..." followed by:

• A surprising statistic
• A patient story
• A common misconception

---

Thread Structure (Twitter)

Hook Tweet

• Strong statement or question
• Numbers or specific claim
• Create curiosity gap

Body Tweets (3-7)

• One idea per tweet
• Build on previous tweet
• Use line breaks for readability

Closing Tweet

• Summarize key insight
• Clear CTA (Follow, Retweet, Comment)
• Link to resource if applicable

Thread Types

1. Story Thread - Personal/patient narrative with lessons 2. Framework Thread - Step-by-step process or system 3. Myth-Busting Thread - Common beliefs vs. evidence

---

Content Quality Checklist

Before publishing:

• [ ] Passes anti-AI detection read
• [ ] Fits one of 4A categories
• [ ] Has specific data/numbers
• [ ] Appropriate for target archetype
• [ ] Matches awareness level
• [ ] Strong hook/headline
• [ ] Clear CTA
• [ ] Natural sentence variation
• [ ] First-person voice where appropriate

Brand Specifications

Color Palette

Typography

Font Family

• Primary: Inter (all weights)
• Fallback 1: Helvetica (macOS system font)
• Fallback 2: Arial (Windows/Linux)
• Fallback 3: System default

Font Sizes

Image Specifications

Instagram Carousel

• Dimensions: 1080 x 1080 px (square)
• Margin: 80px all sides
• Content area: 920 x 850 px
• Footer height: 150px
• Max slides: 10 (Instagram limit)

Instagram Infographic (Future)

• Dimensions: 1080 x 1350 px (portrait)
• Margin: 80px all sides
• Footer height: 150px

Footer Design

┌──────────────────────────────────────────┐
│                CONTENT                    │
│                                          │
├──────────────────────────────────────────┤
│ [Photo] Dr. Shailesh Singh               │
│         @heartdocshailesh                │
└──────────────────────────────────────────┘

• Subtle separator line (Mist Aqua, 2px)
• Profile photo: 100x100px circular
• Photo positioned left, text to the right
• Name in Charcoal
• Handle in Deep Teal

Account Handles

Title Slide Design

• Background: Deep Teal (#207178)
• Text: White (#FFFFFF)
• Centered vertically and horizontally
• Subtitle in Mist Aqua below title

Content Slide Design

• Background: Off-White (#F8F9FA)
• Title: Deep Teal, top-aligned
• Body: Charcoal
• Bullet points: Warm Coral circles (10px diameter)
• Footer at bottom

Accessibility

• Minimum contrast ratio: 4.5:1 for body text
• Title text on teal background: White (15.5:1 ratio)
• Body text on white: Charcoal (12.6:1 ratio)
• All text readable at mobile size

File Naming

• Slides: slide-01.png, slide-02.png, etc.
• Output folder: output/carousels/<topic>/account-<n>/

Input Formats for Content-OS Generators

Overview

All content-os generators accept multiple input formats for flexibility. The generators auto-detect the format based on content structure.

Format 1: Markdown with Separators (Recommended)

Best for quick content creation. Use # for title slide, ## for content slides, --- for explicit slide breaks.

# Main Title
Optional subtitle text

---

## Slide 2 Title
Body text for this slide.

• Bullet point 1
• Bullet point 2
• Bullet point 3

---

## Slide 3 Title
- Also supports dash bullets
- Like this

---

## Final Slide
Call to action or summary here.

Rules:

• # Title = Title slide (teal background)
• ## Title = Content slide title
• --- = Explicit slide separator
• • or - or * = Bullet points
• Blank lines are preserved as spacing

Format 2: JSON Array

Best for programmatic generation or complex layouts.

[
  {
    "title": "Main Title",
    "body": "Subtitle text",
    "type": "title"
  },
  {
    "title": "Content Slide",
    "body": "Body text here.\n• Bullet 1\n• Bullet 2",
    "type": "content"
  },
  {
    "title": "Another Slide",
    "body": "More content",
    "type": "content"
  }
]

Fields:

• title (required): Slide title text
• body (optional): Body content, use \n for line breaks
• type (optional): "title" or "content", defaults to "content"

Format 3: JSON Object with Slides Array

Alternative JSON structure with metadata wrapper.

{
  "slides": [
    {"title": "Title", "body": "Subtitle", "type": "title"},
    {"title": "Slide 2", "body": "Content", "type": "content"}
  ],
  "metadata": {
    "topic": "Hypertension",
    "created": "2024-12-29"
  }
}

Format 4: Plain Text (Fallback)

If no structure is detected, content becomes a single slide.

This is just plain text.
It will all appear on one slide.

Best Practices

For Educational Content

# 5 Signs of Heart Attack
Know these warning signs

---

## 1. Chest Discomfort
• Pressure or squeezing feeling
• Center of chest
• Lasts more than few minutes

---

## 2. Shortness of Breath
• May occur with or without chest pain
• Often the first symptom in women

---

## Take Action
Call emergency services immediately if you experience these symptoms.

For Data-Heavy Content

# Statin Benefits
What the research shows

---

## JUPITER Trial Results
• 44% reduction in heart attacks
• 48% reduction in strokes
• NNT = 95 over 2 years

---

## Who Benefits Most?
• High-risk patients
• Those with elevated CRP
• Family history of early CVD

For Myth-Busting

# Cholesterol Myths Debunked
What you've been told vs. the truth

---

## Myth: Eggs are bad for your heart
TRUTH: For most people, dietary cholesterol has minimal impact on blood cholesterol. 1-3 eggs daily is fine for healthy adults.

---

## Myth: All fats are bad
TRUTH: Unsaturated fats (olive oil, nuts, fish) are heart-protective. It's trans fats you should avoid.

Character Limits

Tips

1. Keep it scannable: Use bullets over paragraphs 2. One idea per slide: Don't overcrowd 3. Strong title slide: Hook the viewer immediately 4. End with CTA: Follow, share, or learn more 5. Use data: Specific numbers are more compelling