| name | animate-avatar |
| description | Generate animated videos from static avatar images using FAL AI. Create looping work and relax animations with Kling V2.6 Pro, LTX, or Veo models. |
| allowed-tools | Bash, Read, Write |
| env | ["FAL_KEY"] |
Animate Avatar Skill
Generate animated videos from static avatar images for use in apps, websites, or social profiles.
Overview
This skill automates the process of:
- Generating multiple video animations from a static avatar image
- Optimizing videos for web delivery
Activity Philosophy
Default Generation: Create 3 videos per avatar:
- 2 Work activities - Shows the character being productive
- 1 Relax activity - Shows the character taking a break
This 2:1 ratio of work-to-relax creates variety and humanizes characters.
Work Activity Prompts (pick 2)
- "Character typing on a computer keyboard"
- "Character writing or signing documents"
- "Character giving a presentation with gestures"
- "Character thinking deeply, tapping chin"
- "Character nodding while listening attentively"
- "Character examining something closely"
- "Character taking notes with a pen"
Relax Activity Prompts (pick 1)
- "Character drinking coffee or tea"
- "Character playing a small guitar"
- "Character eating a snack happily"
- "Character stretching and yawning"
- "Character listening to music, bobbing head"
- "Character waving hello cheerfully"
Models & Pricing
| Model | Flag | Cost | Notes |
|---|
| Kling V2.6 Pro | --model kling | $0.07/sec ($0.35/5s video) | Default, best quality/cost |
| LTX-2-19B | --model ltx | ~$0.20/video | Cheaper for small res |
| Veo 3.1 | --model veo | $0.20/sec ($1.00/5s video) | Highest quality |
Prerequisites
- FAL AI API key set as
FAL_KEY environment variable
- ffmpeg installed for video optimization
Usage
bun .claude/skills/animate-avatar/scripts/animate-avatar.ts \
--avatar "avatar-name" \
--prompts "Character typing on keyboard,Character signing a document,Character drinking coffee"
Parameters
| Parameter | Required | Default | Description |
|---|
--avatar | Yes | - | Avatar name or path to image |
--count | No | 3 | Number of videos to generate |
--prompts | No | Auto | Comma-separated motion prompts |
--model | No | kling | Model: kling, ltx, or veo |
--skip-optimize | No | false | Skip ffmpeg optimization |
Output
Videos are:
- Generated via FAL AI (~70s each)
- Optimized with ffmpeg (320x320, ~150-250KB)
- Saved to the output directory
Tips for Best Results
Good Prompts
- Keep motions subtle - loops better
- Match the character's personality
- Work: typing, writing, presenting, thinking
- Relax: drinking, stretching, waving
Avoid
- Large movements that break the loop
- "Walking", "running", "jumping" - too dynamic
- Complex multi-step actions
Video Specifications
| Property | Value |
|---|
| Resolution | 320x320 |
| Format | MP4 (H.264) |
| Duration | 5 seconds |
| Target Size | ~150-250 KB |
