When to use

Use this skill whenever you need to generate a comprehensive video script for creating a Remotion video. This skill is particularly useful for:

• Product demo videos that showcase features of a web application or software product

• Coding tutorials that explain a codebase or specific technical concepts with animated code

• Animated videos with complex sequences, transitions, and visual effects

• Data visualization videos that present statistics, charts, and dynamic data

• Social media content with captions, effects, and platform-specific optimizations

This skill analyzes your codebase, understands your requirements, and generates a detailed JSON script that can be directly used by Remotion's agent skills to create the final video.

How to use

Read individual rule files for detailed explanations and examples:

• rules/prompt-structure.md - Defines the input structure and requirements for the skill

• rules/script-generation.md - The core prompt for generating detailed video scripts

• rules/animation-patterns.md - Common animation patterns and timing guidelines

• rules/scene-templates.md - Reusable scene templates for common video scenarios

Quick Start

1. Prepare Your Input

Create a JSON object with your video requirements:

{ "goal": "Create a product demo video for our new task management app", "targetAudience": "Project managers and teams looking for productivity tools", "code": "/path/to/your/codebase", "language": "TypeScript", "videoType": "product-demo", "duration": 60, "style": "modern", "animations": ["fade", "slide", "typewriter"], "transitions": ["wipe", "fade"] }

2. Generate the Script

Pass your input to the remotion-script-writer skill. The skill will:

• Analyze your codebase to identify key features and functionality

• Structure the video into logical scenes with appropriate timing

• Design visual elements, animations, and transitions for each scene

• Generate voiceover scripts synchronized with visuals

• List all required assets (images, fonts, audio, etc.)

• Specify technical requirements (Remotion packages, libraries)

3. Use the Output

The skill generates a comprehensive JSON script that includes:

• Video metadata: Title, duration, dimensions, fps, video type

• Scene breakdown: Detailed specifications for each scene

• Visual elements: Text, images, code, animations, transitions

• Audio: Voiceover scripts and background music

• Assets: Complete list of required images, fonts, icons, etc.

• Technical requirements: Remotion packages and third-party libraries

4. Create the Video

Pass the generated script to Remotion's agent skills to:

• Generate React components for each scene

• Implement animations and transitions

• Set up the composition structure

• Preview the video in Remotion Studio

• Render the final video

Example Output

See examples/product-demo-example.json for a complete example of a generated video script.

Supported Video Types

• product-demo : Feature showcases, UI walkthroughs, product announcements

• coding-tutorial : Code explanations, technical concepts, programming tutorials

• animation : Creative animations, motion graphics, visual effects

• data-visualization : Charts, graphs, statistics, animated data

• social-media : Short-form content, viral videos, platform-optimized content

Best Practices

The skill incorporates Remotion best practices:

• All animations use useCurrentFrame() hook for frame-based timing

• Spring animations with natural motion (damping: 200 ) for smooth reveals

• Proper sequencing with <Sequence> , <Series> , and <TransitionSeries>

• Typewriter effects using string slicing (not per-character opacity)

• Deterministic animations (no Math.random() , use random() from remotion)

• Premounting sequences with premountFor prop for better performance

• Accurate duration calculation accounting for transition overlaps

Customization

Modify the rule files to customize the skill:

• prompt-structure.md : Add new input fields or validation rules

• script-generation.md : Adjust the generation prompt or output format

• animation-patterns.md : Add custom animation patterns and effects

• scene-templates.md : Create new scene templates for specific use cases

Advanced Features

Codebase Analysis

The skill can analyze codebases from:

• Local file paths

• GitHub repositories (public or private)

• Code snippets provided directly

It identifies:

• Key functions and components

• Data structures and APIs

• User interactions and workflows

• Technical architecture and patterns

Dynamic Content

Generate scripts with dynamic content:

• Fetch data from APIs for real-time information

• Calculate video duration based on content length

• Adjust scene timing based on voiceover length

• Parameterize content for multiple video variations

Branding Integration

Apply consistent branding:

• Custom color schemes

• Company logos and icons

• Brand-specific fonts

• Visual style guidelines

Limitations

• Maximum recommended video duration: 5 minutes (for performance)

• Code analysis works best with well-documented, structured code

• Voiceover scripts are auto-generated and may require manual refinement

• Asset generation (images, icons) is not included - assets must be provided or described

• Complex 3D animations may require additional manual setup

Support

For questions, issues, or feature requests:

• Consult the README.md for detailed documentation

• Check the examples directory for sample scripts

• Visit remotion.dev for Remotion documentation

• Join the Remotion Discord community for help and discussions

Version

Version: 1.0.0

Last Updated: January 2026

Created by: Manus AI