text-to-lottie

作者: diffusionstudio

撰寫一個可在本地 Skia 播放器中渲染的 Lottie (Bodymovin) JSON 動畫。每當使用者要求建立、生成、編輯或修復 Lottie 動畫,或要求載入「動畫」時使用。

npx skills add https://github.com/diffusionstudio/lottie --skill text-to-lottie

Text To Lottie

Author production-ready Lottie JSON for the official local Skia Skottie player. The deliverable is a renderable scene in the player, not isolated JSON.

Operating Model

  • Use the official player project and verify in Skia Skottie. Do not hand-roll a custom viewer or switch renderers for verification.
  • Keep the skill portable across Agent Skills clients. Avoid host-specific commands, command modes, or orchestration conventions in skill instructions.
  • Prefer fewer questions and stronger defaults. Ask only when a decision changes the output materially, such as transparent vs full-frame background, brand constraints, target format, or supplied source assets.
  • Prioritize clean, intentional, professional motion over merely satisfying the literal prompt.

Reference Loading

This SKILL.md is the thin control plane. Load only one-level references that match the task. Do not open the whole reference library.

Always read references/player-contract.md before creating, editing, fixing, or verifying a scene. If a routed reference is unavailable, continue using the inline rules in this file.

User intentReferences to read when present
Any new/edit/fix Lottie scenereferences/player-contract.md
JSON structure, keyframes, slots, shapes, assetsreferences/lottie-spec-map.md
Logo animationreferences/recipe-logo.md, references/motion-taste.md, references/design-taste.md
Typography, title, quote, text revealreferences/recipe-typography.md, references/design-taste.md, references/motion-taste.md
Lower third, name tag, caption bar, overlayreferences/recipe-lower-thirds.md, references/design-taste.md, references/motion-taste.md
Loader, icon, spinner, badge animationreferences/recipe-loaders-icons.md, references/motion-taste.md
Success, error, warning, completion, empty statereferences/recipe-loaders-icons.md, references/design-taste.md, references/motion-taste.md
UI microinteractionreferences/recipe-ui-microinteractions.md, references/design-taste.md, references/motion-taste.md
Generic "animate this SVG" or SVG-to-Lottiereferences/recipe-svg-animation.md, references/svg-compatibility.md, references/motion-taste.md
Camera follow, pan, zoom, parallax, scene motionreferences/recipe-camera-scene-motion.md, references/design-taste.md, references/motion-taste.md
Diagram, technical line animation, callout, flow tracereferences/recipe-diagram-technical.md, references/design-taste.md, references/motion-taste.md
Data, stats, KPIs, charts, metrics, dashboard figuresreferences/recipe-data-stats.md, references/design-taste.md, references/motion-taste.md
Product launch, feature announcement, social promoreferences/recipe-product-promo.md, references/design-taste.md, references/motion-taste.md
Long text, multiple ideas, list/features/steps, timeline, before/after, problem/solution, quote+proof, recap/story, product walkthrough, multi-language variations, chapters, multi-beat sequence, episode, jump/hard cuts, transition grammarreferences/chapterization-transition-grammar.md, references/motion-taste.md
Glow, glass, metal, gradient, fill, bubble/burst effectsreferences/recipe-visual-effects.md, references/design-taste.md, references/motion-taste.md
SVG input inside logo/icon/UI/lower-third workThe task recipe plus references/svg-compatibility.md
Starter brief or reusable project directionreferences/recipe-starter-projects.md, references/design-taste.md, references/motion-taste.md
Any "premium", "clean", "minimal", "modern", "sleek", or "polished" qualifierreferences/design-taste.md (restraint defaults), plus the routed recipe

For mixed prompts, choose one primary recipe from the main deliverable, then add secondary references for source format or visual treatment. Examples: SVG logo with glow uses logo as primary plus SVG compatibility and visual effects; product launch with pan/zoom uses product promo plus camera scene motion; technical SVG diagram tracing uses diagram/technical plus SVG compatibility; kinetic title with glass sweep uses typography plus visual effects.

Workflow

  1. Route the task using the table above. Read only the relevant references that exist.
  2. Locate the official player project and resolve the target scene using the target precedence below. Before editing, verify the resolved path is public/projects/<project>/<scene-N>/lottie.json; re-read that current file immediately before overwriting because the UI can write slot edits back to source.
  3. Decide the background policy before authoring.
  4. Write or update public/projects/<project>/<scene-N>/lottie.json and, when useful, controls.json.
  5. Validate JSON, run or reuse the dev server, inspect exact frames with ?frame=N, and fix render/design/motion issues before finishing.

Inline Rules

Design Defaults (always apply)

These few defaults are non-negotiable and apply to every designed scene. Load references/design-taste.md for the full reasoning, especially for any "premium", "clean", "minimal", "modern", or "card" prompt.

  • Premium means subtract, not add. When a prompt says premium, clean, minimal, modern, sleek, or sophisticated, default to restraint: remove chrome before adding it. Premium is carried by scale, weight, brightness, spacing, and timing, never by cards, borders, dividers, shadows, glow, or stacked tints.
  • Chrome/container budget is 0 by default. Do not add a framing card, container, border, or divider unless it does a job that whitespace and alignment cannot. Separate grids and columns with negative space and alignment first, a single hairline second, and a filled or bordered card last and only when explicitly warranted.
  • One surface tone. Use one background tone. Do not stack two near-black or two near-white tints to fake a "surface"; it reads muddy. If a card surface must differ from the background, make it one deliberate step with a clear purpose.
  • One divider treatment, one color. If dividers are truly needed, use one weight and one color for all of them, title rule and column rules included. Never use slightly different colors or weights per divider.

Scene Rules

  • Scene files live at public/projects/<project>/<scene-N>/lottie.json.
  • Resolve target scenes by authority: an explicit file path wins; a browser URL route like /<project>/<scene> wins next; an already-known project/scene for the task wins next; otherwise create a new safe scene. Use /__context only for discovery, verification, or playback state unless the task explicitly says to edit what is currently on screen and no more specific target exists. Do not let /__context.live override a known file path, URL, or project/scene. Overwrite main-project/scene-1 only if it is still the untouched placeholder; otherwise create a new scene.
  • Full-frame standalone compositions should include a visible background layer with a bgColor slot and controls.json entry.
  • Transparent-by-default outputs include logos, icons, loaders, overlays, lower thirds, and SVG-derived assets unless the user asks for a background.
  • Include top-level v, fr, ip, op, w, h, nm, assets, and layers. Treat op as exclusive.
  • Use purposeful easing and staging. Avoid defaulting to linear motion. Derive easing from the behavior-based anchors in motion-taste.md (chosen by motion behavior, focal element strongest); do not fall back to one uniform ease for every layer.
  • Use slots for important editable values and add controls.json labels/ranges when they improve the properties panel.
  • For SVG input, preserve the viewBox, normalize styling, watch fill rules and intersections, and verify the result in Skottie.
  • Native Lottie text/text slots (ty:5) render in this player when the scene ships its font: drop a .ttf/.otf/.ttc next to lottie.json, declare it in fonts.list with fFamily matching the font's embedded family name, and reference it from text documents. The loader passes every scene font to Skottie. Prefer native text; reach for vector/shape text only for deliberate path effects (stroke-on, glyph morphs, handwriting). See the player-contract "Native Text" reference.

Verification

Before finishing:

  1. Confirm the intended target file path is public/projects/<project>/<scene-N>/lottie.json.

  2. Validate JSON:

    node -e "JSON.parse(require('fs').readFileSync('public/projects/<project>/<scene-N>/lottie.json','utf8'))"
    
  3. Confirm the official player is running and the scene appears in GET /__context.

  4. Inspect pinned frames in the browser. For new scenes, check frame 0, midpoint, and op - 1.

  5. Confirm the background policy matches the use case.

  6. Check for blank canvas, missing assets, unstyled shapes, wrong layer order, bad easing, awkward timing, cropped content, text overflow, and visible SVG artifacts.

  7. Finish only when the animation renders cleanly and feels intentional.

Maintenance Evals

Do not read eval files during normal animation work. Use them only when testing or changing this skill:

  • evals/trigger-prompts.json
  • evals/routing-prompts.json
  • evals/reference-loading-prompts.json
  • evals/output-rubric.md

相關技能

character-design-sheet
qu-skills
透過參考圖與LoRA技術,確保AI生成角色圖像的一致性。涵蓋轉面視圖、表情圖集、色票與風格一致性技巧。適用於:角色設計、遊戲美術、插畫、動畫、漫畫、視覺小說。觸發詞:角色設計、角色圖集、角色一致性、角色參考、轉面圖、表情圖集、角色美術、一致角色、角色概念、參考圖、角色創作、原創角色設計...
creativedesignmedia
character-design-sheet
halt-catch-fire
透過參考圖與LoRA技術,確保AI生成角色圖像的一致性。涵蓋轉面視圖、表情圖譜、色票與風格一致性技巧。適用於:角色設計、遊戲美術、插畫、動畫、漫畫、視覺小說。觸發詞:角色設計、角色圖譜、角色一致性、角色參考、轉面圖、表情圖譜、角色美術、一致角色、角色概念、參考圖、角色創作、原創角色設計...
creativedesignmedia
character-design-sheet
101-skills
透過參考圖與LoRA技術,確保AI生成角色圖像的一致性。涵蓋轉面視圖、表情表、色票與風格一致性技巧。適用於:角色設計、遊戲美術、插畫、動畫、漫畫、視覺小說。觸發詞:角色設計、角色表、角色一致性、角色參考、轉面圖、表情表、角色美術、一致角色、角色概念、參考圖、角色創作、原創角色設計...
creativedesignmedia
ckm:design
nextlevelbuilder
全方位設計技能:品牌識別、設計標記、UI樣式、標誌生成(55種風格,Gemini AI)、企業識別方案(50項交付物,CIP模擬圖)、HTML簡報(Chart.js)、橫幅設計(22種風格,社群/廣告/網頁/印刷)、圖示設計(15種風格,SVG,Gemini 3.1 Pro)、社群照片(HTML→截圖,多平台)。動作:設計標誌、建立CIP、生成模擬圖、製作投影片、設計橫幅、生成圖示、建立社群照片、社群媒體圖片、品牌...
designcreativemedia
design
nextlevelbuilder
We need to translate the given text from English to Traditional Chinese. The instruction says to preserve product names, protocol names, URLs, numbers, and technical terms. The name "design" is to be preserved only if it appears in the source text. It does appear: "Comprehensive design skill" and later "design logo", etc. So we keep "design" as is. Also preserve "Gemini AI", "Chart.js", "Gemini 3.1 Pro", "SVG", "HTML", "CIP", "UI styling", "brand identity", "design tokens", etc. Numbers like 55, 50, 22, 15 should be preserved. The text inside <text> is the only thing to translate. No extra labels. Output only the translation. Let's translate carefully: "Comprehensive design skill: brand identity, design tokens, UI styling, logo generation (55 styles, Gemini AI), corporate identity program (50 deliverables, CIP mockups), HTML presentations (Chart.js), banner design (22 styles, social/ads/web/print),
mediadesigncreative
ace-step
agentspace-so
Generate, inpaint, and outpaint music with ACE Step on RunComfy via the `runcomfy` CLI. ACE Step is StepFun-AI's open-weights music foundation model — tag-driven composition (genre, mood, instruments), multilingual lyrics with section markers, 5 s to 4 min stereo output, $0.0002–0.0003 per second (≈ 27× cheaper than ElevenLabs Music). Four endpoints: ACE Step text-to-audio (the default), ACE Step 1.5 text-to-audio (50+ language lyrics, refined structured-lyric handling), ACE Step...
creativeaudiomedia
ace-step
doany-ai
Generate, inpaint, and outpaint music with ACE Step on RunComfy via the `runcomfy` CLI. ACE Step is StepFun-AI's open-weights music foundation model — tag-driven composition (genre, mood, instruments), multilingual lyrics with section markers, 5 s to 4 min stereo output, $0.0002–0.0003 per second (≈ 27× cheaper than ElevenLabs Music). Four endpoints: ACE Step text-to-audio (the default), ACE Step 1.5 text-to-audio (50+ language lyrics, refined structured-lyric handling), ACE Step...
creativemediaaudio
ai-avatar-video
qu-skills
透過 inference.sh CLI 建立 AI 虛擬人偶與說話頭影片。推薦:P-Video-Avatar(最快、最便宜、內建 TTS)。另可選:OmniHuman、Fabric、PixVerse。音訊:Inworld TTS-2(100 多種語言、角色情感引導)、ElevenLabs、Kokoro。功能:音訊驅動虛擬人偶、文字轉虛擬人偶、唇形同步影片、說話頭生成、虛擬主持人、UGC 內容。用途:AI 主持人、解說影片、虛擬網紅、配音、行銷影片、UGC 廣告、遊戲虛擬人偶……
videocreativemedia