unity-primetween-design

Provides source-anchored design rules for writing and reviewing PrimeTween 1.4.6 animation code in Unity.

1.7k|162|Updated Jan 18, 2026
One-click install
npx skills add https://github.com/Besty0728/Unity-Skills --skill unity-primetween-design
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-primetween-design
Source: https://github.com/Besty0728/Unity-Skills/tree/main/SkillsForUnity/unity-skills~/skills/primetween-design
Command: npx skills add https://github.com/Besty0728/Unity-Skills --skill unity-primetween-design

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

PrimeTween's API differs significantly from DOTween (struct handles, Chain/Group/Insert instead of Append/Join), and developers often write incorrect tween lifecycle code based on wrong assumptions. This Skill grounds AI-generated PrimeTween code in the actual 1.4.6 package source, preventing misuse of dead tween handles, wrong sequence composition, and allocation-heavy callback patterns.

Core Features & Use Cases

  • Source-Anchored Rules: Eight critical design rules each cited to exact files and line numbers in the PrimeTween 1.4.6 package (e.g., Runtime/Tween.cs, Runtime/Sequence.cs).
  • Lifecycle & Memory Guidance: Covers struct tween handle reuse, destroyed-target detection via PrimeTweenConfig, zero-allocation OnComplete<T> callbacks, and when to prefer Sequence over await or coroutines.
  • Module Routing: Directs to related modules (async, unitask-design, inspector, performance, addressables-design) when a task crosses domain boundaries.
  • Use Case: Before writing a UI fade sequence with chained scale animations, load this module so the AI uses Sequence.Create with Chain/Group correctly instead of DOTween-style fluent setters.

Quick Start

Load the primetween-design module before writing or reviewing any PrimeTween tween, sequence, or callback code in my Unity project.

Frequently Asked Questions about unity-primetween-design

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

FAQPage Schema
How do I write PrimeTween sequences in Unity?

Use Sequence.Create to configure cycles, easing, and update type, then compose with Chain for sequential tweens, Group for parallel tweens against the previous item, and Insert for absolute-time overlap. This replaces DOTween's Append/Join vocabulary.

What is the difference between PrimeTween and DOTween?

PrimeTween uses static Tween factories returning struct handles, while DOTween uses fluent setters on reusable tween objects. PrimeTween composes sequences with Chain/Group/Insert instead of Append/Join, and has no SetLink API for target lifetime handling.

Can I reuse a PrimeTween tween handle after it completes?

No. A PrimeTween Tween handle is a struct, and a completed or stopped handle is dead and non-reusable. Create a new tween to replay or reverse an animation instead of restarting the old handle.

Does PrimeTween support async await and coroutines?

Yes, PrimeTween supports await tween and ToYieldInstruction(), but both async state machines and coroutines allocate memory. For allocation-sensitive animation flows, prefer Sequence-based composition instead.

How does PrimeTween handle destroyed Unity targets?

PrimeTween detects destroyed Unity targets and exposes targeted warnings through PrimeTweenConfig. You can also bind callbacks with OnComplete<T> so the callback is suppressed when its target is destroyed, avoiding capturing closures.

Which Unity versions does PrimeTween 1.4.6 support?

The PrimeTween UPM package supports Unity 2018.4 and later. However, the Unity Skills project itself maintains a Unity 2022.3+ baseline, so check the installed package version before relying on newer factory overloads.