semantic-performance-builder

Build choreographed multi-step emotion sequences with timed transitions and callbacks.

18|1|Updated Sep 3, 2025
One-click install
npx skills add https://github.com/joshtol/emotive-engine --skill semantic-performance-builder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: semantic-performance-builder
Source: https://github.com/joshtol/emotive-engine/tree/main/skills/semantic-performance-builder
Command: npx skills add https://github.com/joshtol/emotive-engine --skill semantic-performance-builder

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill empowers you to move beyond simple, single-emotion changes by designing rich, multi-step emotional narratives, allowing your AI to convey complex intentions and feedback with greater expressiveness.

Core Features & Use Cases

  • Choreographed Sequences: Design multi-step sequences of emotions, gestures, and precise timings to convey specific meanings or intentions.
  • Common Performance Patterns: Access and adapt pre-defined templates for welcome greetings, celebrations, error recovery, and thinking states.
  • Timing Guidelines: Learn best practices for transition durations (quick, standard, extended) to create natural and impactful animations.
  • Use Case: Design a "welcome" sequence for a new user onboarding flow, starting with 'anticipation', transitioning to a 'joyful wave', and settling into a 'calm' state, making the AI feel more engaging and personalized.

Quick Start

Use the semantic-performance-builder skill to create a "celebration" performance, including 'anticipation', 'joy' with a 'bounce' gesture, and 'excitement' with an 'explode' gesture.

Frequently Asked Questions about semantic-performance-builder

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

FAQPage Schema
How do I choreograph multi-step emotion sequences for AI animations?

Choreograph multi-step emotion sequences by defining a performance object with named steps, each specifying an emotion, duration, and optional gesture. Apply timing guidelines (quick, standard, extended) and use pre-built patterns like welcome, celebration, or error recovery to structure timed transitions that convey complex emotional narratives.

What are the common animation patterns I can use for onboarding and error flows?

Common patterns include welcome sequences for user greetings, celebration animations for positive outcomes, error recovery flows for failure states, and processing sequences for thinking states. Each pattern provides pre-defined templates with emotion and gesture combinations you can adapt for context-appropriate interactions.

Can I add callbacks and triggers to control when animations play?

Yes, choreographed sequences expose callbacks for onStart, onStepChange, and onComplete events, and support defined triggers to control when performances activate. This lets you respond to user actions or system events with timed emotion transitions and gesture sequences.

How do gesture and emotion timing work together in a performance sequence?

Each step in a performance combines an emotion with an optional gesture and duration. Timing guidelines (quick for snappy transitions, standard for natural pacing, extended for emphasis) ensure gestures sync with emotion changes, creating coherent multi-step animations that feel expressive rather than jarring.

What's the difference between a single emotion change and a choreographed sequence?

Single emotion changes apply one state instantly. Choreographed sequences layer multiple emotions, gestures, and precise timings across steps, allowing you to convey intent, feedback, and personality through rich narrative arcs rather than flat state switches.

Do I need prior animation experience to build emotion sequences?

No. Pre-defined performance patterns and timing guidelines handle animation complexity. You define the emotional arc and gestures you want; the Skill structures them into properly-timed sequences for the emotive-mascot engine.