name: semantic-performance-builder description: Build choreographed multi-step emotion sequences (semantic performances) for complex interactions. Use when designing welcome sequences, error recovery flows, or celebration animations. trigger: semantic performance, sequence, choreography, multi-step, performance design

Semantic Performance Builder

You are an expert in designing choreographed emotion sequences (semantic performances) for the emotive-mascot engine.

When to Use This Skill

Creating welcome/onboarding sequences
Designing celebration or achievement animations
Building error recovery flows
Creating context-appropriate interaction sequences
Timing complex multi-emotion transitions

What is a Semantic Performance?

A semantic performance is a choreographed sequence of emotions, gestures, and timings that together convey a specific meaning or intention.

Basic Structure

const performance = {
    name: 'welcome',
    steps: [
        { emotion: 'anticipation', duration: 800 },
        { emotion: 'joy', duration: 1200, gesture: 'wave' },
        { emotion: 'calm', duration: 1000 },
    ],
    triggers: {
        onStart: mascot => {
            console.log('Performance started');
        },
        onStepChange: (mascot, step) => {
            console.log('Step:', step);
        },
        onComplete: mascot => {
            console.log('Performance complete');
        },
    },
};

Common Performance Patterns

Welcome/Greeting

{
  name: 'welcome',
  steps: [
    { emotion: 'anticipation', duration: 600 },
    { emotion: 'joy', duration: 1000, gesture: 'wave' },
    { emotion: 'calm', duration: 800 }
  ]
}

Celebration

{
  name: 'celebration',
  steps: [
    { emotion: 'anticipation', duration: 500 },
    { emotion: 'joy', duration: 800, gesture: 'bounce' },
    { emotion: 'excitement', duration: 1000, gesture: 'explode' },
    { emotion: 'pride', duration: 800, gesture: 'shimmer' }
  ]
}

Error Recovery

{
  name: 'errorRecovery',
  steps: [
    { emotion: 'concern', duration: 800 },
    { emotion: 'empathy', duration: 1000 },
    { emotion: 'encouragement', duration: 1200 }
  ]
}

Thinking/Processing

{
  name: 'processing',
  steps: [
    { emotion: 'focus', duration: 600 },
    { emotion: 'contemplation', duration: 1200, gesture: 'pulse' },
    { emotion: 'anticipation', duration: 800 }
  ]
}

Timing Guidelines

Quick transitions: 300-600ms (attention-grabbing)
Standard transitions: 800-1200ms (natural feel)
Extended transitions: 1500-2000ms (emphasis)
Total performance: 3-6 seconds (avoid too long)

Use Case Examples

See the main emotion-choreographer skill for detailed implementation patterns, or mascot-integrator for use case-specific examples.

semantic-performance-builder