lottie-motion

Integrates Lottie and dotLottie asset animations into HyperFrames world-motion scenes.

Updated Jul 22, 2026
One-click install
npx skills add https://github.com/Chau165/local_skill --skill lottie-motion-chau165
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lottie-motion
Source: https://github.com/Chau165/local_skill/tree/main/codex/skills/lottie-motion
Command: npx skills add https://github.com/Chau165/local_skill --skill lottie-motion-chau165

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires lottie-web, @lottiefiles/dotlottie-web, @lottiefiles/dotlottie-io.

What problem does it solve? Reusable assets like wheels, gauges, smoke, and character gestures need self-contained internal animation, but hand-coding that motion with GSAP for every scene is repetitive and error-prone. This Skill routes pre-baked Lottie/dotLottie animations into HyperFrames world-motion explainers without breaking scene choreography or render determinism. ## Core Features & Use Cases - Decision guidance: Distinguishes when to use Lottie (internal asset motion like a spinning wheel or rising smoke) versus plain SVG + GSAP (world-level travel, collision, and cause-and-effect motion). - Deterministic runtime contract: Enforces HyperFrames rules such as autoplay: false, synchronous player registration on window.__hfLottie, and seek-driven playback instead of wall-clock timers. - dotLottie asset tooling: Uses the shared dotlottie-io toolkit to inspect, create, or modify .lottie files, then copies the result into the project's assets/ folder. - Use Case: While building a factory explainer video, add a looping pump-cycle Lottie animation inside a machine layer while HyperFrames and GSAP still control camera travel and scene timing. ## Quick Start Use the lottie-motion skill to add a deterministic Lottie wheel animation to my HyperFrames world-motion video.

Frequently Asked Questions about lottie-motion

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a Lottie animation to a HyperFrames video?

Load the Lottie file as a local project asset with autoplay set to false and loop disabled, then register the player synchronously on window.__hfLottie. HyperFrames seeks the asset and owns the composition timeline, so never call play() or use timers.

When should I use Lottie instead of GSAP for animation?

Use Lottie when a reusable asset has its own finite internal motion, such as a wheel turning, smoke rising, or a gauge changing. Use SVG plus GSAP when a subject travels, collides, or interacts with another subject in the world.

Can I use dotlottie-io to edit .lottie files?

Yes, the shared motion-toolkit includes dotlottie-io for inspecting, creating, or modifying .lottie assets. Copy the resulting .json or .lottie file into the project's assets folder so the video project does not depend on the shared toolkit.

Why does my Lottie animation break during HyperFrames render?

Render failures usually come from calling play(), using wall-clock timers, or registering the player asynchronously. Render-critical motion must be seek-driven with autoplay disabled, and world-motion-audit.mjs must pass before rendering.

What are the limitations of using Lottie in world-motion scenes?

Lottie cannot substitute for world-level cause-and-effect interaction or independent actor and target motion. The scene's actor and target still need their own visible, seek-safe state changes handled by HyperFrames and GSAP.