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.