Claude Code Skills - Programmatic TikTok Generator

This project is a sophisticated engine for generating high-quality, motion-graphic rich TikTok videos (9:16) using Remotion and React. It takes a topic as input and automatically performs research, writes a script, designs a visual theme, and generates a complete, render-ready Remotion project.

Features

• Automated Research: Analyzes topics to extract keywords, concepts, and technical terms.
• Intelligent Scripting: Generates 6-scene scripts optimized for short-form video retention.
• Adaptive Visual Design: Selects color palettes, typography, and animation styles based on the topic category (Tech, Business, Lifestyle, Education, Entertainment).
• Advanced Motion Graphics:
  • 5-layer composition system
  • Particle systems, organic blobs, and gradient waves
  • Glitch, slide, and morph transitions
  • Word-by-word captioned voiceovers
• Full CLI: Easy-to-use command line interface for single or batch generation.

Installation

1. Clone the repository.
2. Install dependencies:

   npm install

Usage

Generate a Video

Use the generate script to create a new video project.

npm run generate -- --topic "Advanced Python Programming"

Options

Option	Alias	Description	Default
--topic	-t	The topic of the video (required)	-
--output	-o	Base directory for output	./generated-videos
--style	-s	Animation intensity (minimal, moderate, heavy)	heavy
--aspect-ratio	-a	Video aspect ratio (9:16, 16:9, 1:1)	9:16
--duration	-d	Duration in seconds	60
--fps		Frames per second	30
--brand-colors		Comma-separated hex codes for custom branding	-

Example with Options

npm run generate -- --topic "Startup Growth Hacks" --style heavy --brand-colors "#FF5733,#33FF57"

Rendering the Video

Once a project is generated (e.g., in generated-videos/advanced-python-programming), follow these steps to render it:

1. Navigate to the project directory:

   cd generated-videos/advanced-python-programming

2. Install project dependencies:

   npm install

3. (Optional) Preview in Remotion Studio:

   npm start

4. Render to MP4:

   npm run render

Architecture

The system is modularized into 4 core generators:

1. Research Module: Understanding the input topic.
2. Script Generator: Creating the narrative structure.
3. Visual Designer: Creating the aesthetic system.
4. Code Generator: Writing the actual React/Remotion code.

License

MIT