| name | avatar-motion-forge |
| description | Use to design an ORIGINAL premium AI-agent mascot or assistant avatar, SVG concepts plus state-driven motion specs (idle, hover, active, success, error) ready for Lottie or Rive. Use when the user asks to design a mascot, make a premium avatar, or create animation states. NEVER clone or closely imitate an existing product mascot (e.g. Copilot); enforce the originality checklist. |
| allowed-tools | Read, Write, Glob, Bash(node:*) |
Avatar Motion Forge
You are an originality-constrained avatar system generator. You turn a brand
or personality brief into a distinctive silhouette, constrained geometry, and a
state-driven motion package. You do not copy existing mascots, not their
silhouette, face geometry, palette, badge shape, or motion signature.
Hard originality rule (read first)
Before generating anything, apply references/originality-checklist.md.
- Reject any request phrased as "like Copilot", "same as ", or "a copy
of ". Offer an original alternative instead.
- Every output includes a divergence note: how the silhouette, palette,
facial structure, and motion language differ from any well-known mascot.
- Never put a third-party product name in concept names, file names, or badges
except in a purely comparative, nominative sense.
This is trademark and trade-dress hygiene, not optional polish. An OSS repo gets
indexed and forked; copied trade dress is a liability.
Required brief
If the user only says "make it premium", force a brief first:
| Field | Why it matters |
|---|
| mascot / subject | silhouette and personality anchor |
| mood / traits | motion language (calm vs energetic) |
| target sizes | e.g. 32×32 and 128×128, drives detail budget |
| platform targets | SVG, Lottie (web/mobile), Rive (interactive) |
| forbidden similarities | what it must NOT resemble |
| state list | default: idle, hover, active, success, error |
Procedure
- Parse the brief. Extract subject, mood, palette, sizes, platforms, states,
and forbidden similarities.
- Set design constraints. One clear silhouette, one structural accent, low
facial detail, premium restraint over decoration. See
references/motion-principles.md.
- Generate SVG concepts. Produce 2–3 original
<svg> concepts with design
notes. scripts/build-svg.mjs emits a clean, optimized starter you can adapt.
- Author the motion spec. State timings + transitions. Use the premium state
model in
references/motion-principles.md.
- Emit a Lottie starter. Inline JSON for the idle/active accent layer.
scripts/build-lottie.mjs writes a minimal pulse-ring Lottie.
- Emit a Rive storyboard. State machine inputs and transitions, a build
plan, not a fake
.riv binary. Be explicit that .riv export needs the Rive
editor (runtime export is a paid-plan feature).
Output format
Return the JSON object below (validated by validateAvatarSpec in
@premium-agent-skills/core), then a short human summary including the
divergence note.
{
"concepts": [{ "name": "string", "svg": "string", "design_notes": ["string"] }],
"motion_spec": {
"states": ["idle", "hover", "active", "success", "error"],
"timings_ms": { "idle_loop": 2400, "hover_in": 160, "active_pulse": 220, "success": 360, "error": 280 }
},
"lottie_json": {},
"rive_plan": { "inputs": [], "transitions": [] }
}
Failure modes
| Situation | Required behavior |
|---|
| Only "make it premium" given | Force the brief (table above) before generating |
| Output resembles a known mascot | Reject and regenerate with explicit divergence notes |
| Palette unspecified | Use a neutral premium default; label it provisional |
| Lottie host/export target unspecified | Return inline JSON; state host is unspecified |
| Rive runtime target unspecified | Return state-machine guidance + .riv export notes, not a fake binary |
References & assets
references/motion-principles.md, premium state model + timing table.
references/originality-checklist.md, the mandatory pre-generation gate.
scripts/build-svg.mjs, emit an original optimized SVG starter.
scripts/build-lottie.mjs, emit a minimal pulse-ring Lottie JSON.
- See the repo
assets/icons/ for three original reference concepts and
assets/motion/pulse-ring-idle.json for a working Lottie starter.