semantic-performance-builder

joshtol's avatarfrom joshtol

Build choreographed multi-step emotion sequences (semantic performances) for complex interactions. Use when designing welcome sequences, error recovery flows, or celebration animations.

⭐10stars🔀1forks📁View on GitHub🕐Updated Nov 21, 2025

When & Why to Use This Skill

The Semantic Performance Builder is a specialized tool designed to create sophisticated, multi-step emotion sequences and choreographed animations for interactive mascots. It enables developers and designers to define 'semantic performances'—precise combinations of emotions, gestures, and timings—that transform static UI feedback into expressive, context-aware user experiences. By streamlining the workflow for complex interaction design, it helps bridge the gap between technical implementation and creative character expression.

Use Cases

  • User Onboarding & Welcome: Designing multi-stage greeting sequences that build rapport with new users through friendly gestures and welcoming emotional transitions.
  • Empathetic Error Recovery: Crafting nuanced animation flows that transition from concern to encouragement, helping to reduce user frustration during technical issues or invalid inputs.
  • Achievement & Milestone Celebrations: Building high-energy, choreographed sequences (e.g., anticipation to joy to pride) to reward users for completing tasks or reaching significant goals.
  • Interactive System Feedback: Creating 'thinking' or 'processing' states that use subtle emotional shifts and rhythmic gestures to keep users engaged during background operations.
  • Contextual Brand Interaction: Developing a library of brand-consistent emotional responses that allow a mascot to react dynamically to various user behaviors and system events.
namesemantic-performance-builder

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.

Resources