---
name: lottie-motion-builder
description: Build or refine small production-ready Lottie animations from SVGs, logos, UI states, loaders, and branded motion assets with a local preview harness, explicit inputs, and output verification. Use when the user asks for Lottie, JSON animation, SVG reveal animation, logo animation, or lightweight motion assets for product surfaces.
license: MIT
metadata:
  abvx_status: experimental
  abvx_origin: adapted
---

# Lottie Motion Builder

Use Lottie for small deployable motion assets, not for full cinematic motion-design work.

## Good Fits

- SVG path reveal
- logo or wordmark animation
- loader, empty-state, success-state, and transition animation
- small branded motion element for web, mobile, or app onboarding

## Do Not Use It For

- long character animation
- complex scene choreography
- vague "make it cool" requests with no asset grounding
- motion work that does not need to ship as Lottie JSON

## Required Inputs

Before building, lock these down:

- source asset: SVG, screenshot, logo, icon, or concrete visual reference;
- target surface: landing page, app UI, loader, hero accent, onboarding, etc.;
- duration and loop behavior;
- target runtime: web, React Native, iOS, Android, or generic Lottie JSON;
- editable controls needed at runtime: background, color, size, stroke, speed, etc.

If the user gives only a vague motion request, ask for or derive one concrete asset first.

## Harness Rule

Use the external diffusionstudio/lottie harness rather than inventing a custom player.

- Read [references/external-harness.md](references/external-harness.md) before setup.
- Bootstrap or refresh the harness with `scripts/bootstrap_harness.sh`.
- Keep generated animation files inside the harness project while iterating.
- Treat the upstream harness as the rendering contract for preview and slot behavior.

## Workflow

1. Confirm the asset, target surface, duration, loop mode, and runtime target.
2. Bootstrap the external harness if needed.
3. Generate or edit `public/lottie.json` in the harness project.
4. Expose at least one background-color control and any explicitly requested controls.
5. Run the local preview and visually verify the result.
6. Run `motion-review-gate` when the asset is meant for a product UI surface rather than a throwaway demo.
7. Export the usable artifact set and summarize how to embed it.

## Output Contract

Produce these artifacts when the user asks for a usable result:

- `animation.json` or the final `lottie.json`;
- one visual verification artifact: screenshot, gif, or short mp4;
- a short embed note for the target runtime;
- any runtime-editable controls used by the animation.

## Verification

- The JSON parses in the harness.
- The motion is visible and not blank.
- Loop points are intentional.
- Background control exists.
- Dimensions, duration, and FPS match the request.
- The asset is small enough for the intended product surface.
- Product-surface motion has passed `motion-review-gate` or the exception is stated.

## Reporting

In the final report, include:

- source asset used;
- output path;
- preview path or URL;
- runtime target;
- controls exposed;
- known limitations.


---
Source attribution: markoblogo
Original project: https://github.com/markoblogo/abvx-agent-skills/blob/37a7146d940e6720a89e3281b0ddd9a0fcaf1f62/skills/lottie-motion-builder/SKILL.md
License: MIT
License information: https://opensource.org/license/mit
Original upstream instructions; downloaded from Mega AI Hub.

## Upstream license notice

MIT License

Copyright (c) 2026 Anton Biletskiy-Volokh

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.



# Mega AI Hub resource metadata

Creator / publisher: markoblogo
Original project: https://github.com/markoblogo/abvx-agent-skills/blob/37a7146d940e6720a89e3281b0ddd9a0fcaf1f62/skills/lottie-motion-builder/SKILL.md
Attribution basis: Source repository record

Fields of work: Design, Development & Engineering
Roles: Frontend Developer, Motion Designer, UX Designer
Specialties: Design
Tools: Diffusionstudio/Lottie
Country applicability: Country not specified
Classification basis: Source catalog labels
Instruction SHA-256: 61fa423b49f8cd4c1ae73e30997a935bbf22a22902e35c1b5d2569b0c3de66e8