---
name: unity-primetween
description: Inspect PrimeTween Free and generate runtime tween scripts
---

> **Before calling any skill in this module:** if you are about to call a skill with parameters guessed from its name or description, STOP — read this file (or fetch its schema via `GET /skills/recommend?includeSchema=true`) first. If you already have the parameter definitions from recommend/schema, you may proceed straight to dryRun.

## Triggers
- Checking a PrimeTween installation
- Exploring supported animation APIs
- Generating Transform/Sequence animation code
- 检查 PrimeTween 安装状态、探索动画 API、生成 Transform/Sequence 动画代码

# PrimeTween Skills

PrimeTween Free support is intentionally tailored to its API rather than mirroring DOTween: it discovers static factories, reads process-wide configuration, and generates runtime scripts that own and stop their `Tween` or `Sequence` handles. It does not configure a DOTween-style settings asset or create PrimeTween Pro components.

## Guardrails

- PrimeTween must be installed as `com.kyrylokuzyk.primetween`.
- Query skills (`primetween_get_status`, `primetween_get_config`, `primetween_list_factories`) run directly in all operating modes.
- Auto-forbidden in this module: the two script generators `primetween_generate_tween_script` and `primetween_generate_sequence_script` (both `MayTriggerReload = true`, `RiskLevel = "high"` — writing a new `.cs` triggers compilation + Domain Reload). They return `MODE_FORBIDDEN` under Approval **and** Auto, and are reachable only under Bypass mode or via a user-managed Allowlist entry; the grant flow returns `MODE_FORBIDDEN` too, so do not attempt it.
- `primetween_get_config` is read-only. `PrimeTweenConfig` is runtime state, not a serialized project configuration asset.
- Generated scripts support Transform `Position`, `LocalPosition`, `EulerAngles`, `LocalEulerAngles`, and `Scale`. Use `primetween_list_factories` before requesting an API outside that supported generator set.
- PrimeTween handles are non-reusable. Generated scripts stop their owned live handle on disable instead of using a DOTween `SetLink` equivalent.

## Free Skills

### `primetween_get_status`
Report whether PrimeTween is installed, its package version, assembly, and visible core types.

**Parameters:** None.

### `primetween_get_config`
Read the current global runtime values exposed by `PrimeTweenConfig`.

**Parameters:** None.

### `primetween_list_factories`
List public static methods from one PrimeTween API type.

**Parameters:** `typeName="Tween"` (Tween, Sequence, Shake, or PrimeTweenConfig), `methodPrefix?`, `limit=100`.

### `primetween_generate_tween_script`
Create a Transform-focused PrimeTween MonoBehaviour that owns its `Tween` and stops it on disable.

**Parameters:** `className`, `folder="Assets/Scripts/PrimeTween"`, `namespaceName?`, `tweenKind="LocalPosition"`, `duration=1`, `ease="OutQuad"`, `cycles=1`, `cycleMode="Restart"`, `autoPlay=true`.

### `primetween_generate_sequence_script`
Create a PrimeTween MonoBehaviour that uses `Sequence.Chain` and `Sequence.Group` with supported Transform tween factories.

**Parameters:** `className`, `folder="Assets/Scripts/PrimeTween"`, `namespaceName?`, `tweenKind="Scale"`, `duration=0.2`, `ease="OutBack"`, `cycles=1`, `sequenceCycleMode="Restart"`, `autoPlay=true`, `stepsJson?`.

`stepsJson` is a JSON array of `{ "op": "Chain|Group", "tweenKind": "Scale", "duration": 0.2 }`.

## Exact Signatures

Exact names, parameters, defaults, and return values are defined by `GET /skills/schema` or `unity_skills.get_skill_schema()`, not by this file.