blitzreels/agent-skills

Overview

This skill creates TikTok and Instagram carousel projects (still slides with text overlays) using the BlitzReels API. It models carousels as carousel-type projects, uploads images as media assets, places one image per timeline segment, and adds timed text overlays for each slide. The output is an mp4 slideshow export suitable for social platforms.

How this skill works

It creates a project with project_type:"carousel" and stores platform settings in carousel_settings. Slide backgrounds are uploaded via media endpoints, each image is added to the timeline at start_seconds = slideIndex * slideDuration, and text is added as time-windowed text overlays with explicit position_x/position_y coordinates. Finally, export the assembled slideshow as an mp4 using the export endpoint.

When to use it

• You need static-image carousels for TikTok Photo Mode or Instagram feed.
• You want per-slide readable text with precise positioning and stroke for mobile legibility.
• You need an mp4 slideshow export rather than a ZIP of individual slide images.
• You must guarantee consistent timing and per-slide CTAs or hooks.
• You want programmatic bulk generation of social carousels from URLs and titles.

Best practices

• Respect the Readability Rules: max 40 chars/line and max 4 lines/slide; split long copy across slides.
• Always use text-overlays endpoint for slide text; do not use motion graphics for static slide text.
• Apply a 6px stroke and high contrast (WCAG AA minimum) for legibility on mobile.
• Manually set position_x/position_y because safe_area_preset is metadata only; test for platform UI overlays.
• Use consistent vertical positioning across slides and keep bottom margins generous to avoid captions/controls.

Example use cases

• TikTok 3-slide hook-value-CTA carousel with 9:16 aspect ratio and slightly left-aligned text to avoid right-side UI.
• Instagram 4:5 educational carousel with five slides following hook → steps → recap pattern.
• Batch-generate product feature carousels from image URLs and per-slide titles using scripts/carousel.sh.
• Create social-ready mp4 previews for designers to review timing and legibility before posting.