emotion-choreographer

Define emotion objects and choreograph particle gestures for the emotive-mascot animation engine.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solves? This Skill allows you to go beyond default expressions, enabling you to design unique emotion behaviors and particle choreography that perfectly match your AI's personality and specific application contexts.

Core Features & Use Cases

  • Custom Emotion Definitions: Define new emotions by configuring particle count, speed, color, formation, and physics properties to create distinct visual characteristics.
  • Gesture Design: Create custom particle gestures like wave, bounce, or explode to enhance emotional expression and interaction.
  • Semantic Performance Integration: Combine your custom emotions and gestures into multi-step choreographed sequences for complex narratives.
  • Use Case: Your AI assistant needs to express "confusion" with a unique visual. Use this skill to define a new 'confused' emotion with scattered particles and a 'questionMark' gesture, making the AI's internal state visible and relatable.

Quick Start

Use the emotion-choreographer skill to define a new emotion called 'myNewEmotion' with 600 particles, a spiral formation, and a vibrant pink color.

Frequently Asked Questions about emotion-choreographer

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

FAQPage Schema
How do I create custom emotions for an AI animation with particles and gestures?

Custom emotions are defined in src/config/emotions.js by configuring particle count, speed, color, formation, and physics properties. Each emotion object specifies visual characteristics like bounce, glow, and trail length, which the animation engine renders as distinct behavioral states synced to your AI's personality.

What's the best way to choreograph particle animations and gesture sequences?

Choreograph particles by designing emotion behaviors with formation types and physics settings, then combine them into semantic performances—multi-step sequences with stepwise timing and triggers. This lets you create complex narratives where particle animations respond to user interactions and internal state transitions.

Can I sync particle animations with AI interactions and emotion transitions?

Yes. Particle animations integrate with the GestureEngine, SemanticPerformanceEngine, and PhysicsEngine to sync with user interactions and emotion state changes. Configure responsive animations that maintain 60fps performance and smooth transitions between emotions while upholding semantic clarity.

How do I troubleshoot particle physics and animation performance issues?

Optimize particle physics by tuning speed, energy, bounce, and formation parameters in emotion definitions. The PhysicsEngine and FormationEngine handle rendering; adjust particle count and trail length to maintain 60fps while preserving visual clarity and energy balance across transitions.

What design principles should I follow when building custom emotion behaviors?

Follow smooth transitions, 60fps performance targets, semantic clarity (emotion visually matches its meaning), energy balance (particle intensity reflects emotional intensity), and color psychology (colors reinforce emotional context). These principles ensure animations are both performant and emotionally intelligible.

Do I need to modify core systems to create new emotion behaviors?

No. Define new emotions by configuring emotion objects in src/config/emotions.js; the skill exposes and maps built-in gestures and integrates with core systems automatically. You design the emotion configuration; the GestureEngine, SemanticPerformanceEngine, and PhysicsEngine handle rendering and orchestration.