MAHMOUD ABDELNABY
Content · CLI SCRIPT · 2

Carousel Slide Density & Swipe Pacing Auditor

Audit your LinkedIn and Instagram carousels for slide text density, reading fatigue, and swipe momentum before designing.

Problem it addresses

Create an automated carousel pacing auditor in Python (carousel_auditor.py): 1) Ingests multi-slide Markdown or JSON files representing social carousels, 2) Evaluates word density per slide (flagging >50 words), 3) Checks for presence of cliffhanger transition hooks between slides, 4) Generates an interactive visual HTML preview simulating mobile swipe flow with pass/fail metrics.

Who it is for

PRO operating in high-growth e-commerce, digital publishing, and direct-response marketing across Saudi Arabia, UAE, and Egypt.

What is inside

Key files listed in the README repository architecture:

  • data/copywriting_angles_ar.json
  • data/dialect_variations.csv
  • docs/angle-selection-guide.md
  • examples/good_and_bad_carousel.json
  • frameworks/10-slide-carousel-architecture.md
  • LICENSE
  • README.md
  • reports/preview_simulation.html
  • SOURCES.md
  • src/carousel_auditor.py
  • tests/test_auditor.py
  • tests/test_carousel.py

How to evaluate and use it

  1. Read the README first and confirm that the documented problem matches your use case.
  2. Inspect the listed files to find the data, tools, templates, and tests relevant to your task.
  3. Follow the repository’s Quick Start and check prerequisites before running commands.
  4. Compare outputs with documented examples and review limitations before using them in a decision or client workflow.

Quick Start from the README: python -m unittest discover -s tests · python src/carousel_auditor.py --help

Scope and limitations

  • Cognitive Load Limits: Enforces maximum word counts (30-50 words per slide) to ensure comfortable mobile legibility without pinch-to-zoom.
  • Visual Hook & Drop-Off Pacing: Audits slide 1 visual punch and slide 2 bridge question to minimize initial swipe drop-off.
  • Safe Zone Padding: Keeps text and critical illustrations away from outer margins and platform swipe navigation badges.

This page summarizes the available documentation; it does not establish performance or business results. Verify data and prerequisites before use.

Related repositories