wave

Play wave animations with selectable styles during greetings, farewells, and introductions in real-time agent interactions.

5|Updated May 2, 2026
One-click install
npx skills add https://github.com/nirholas/three-ui --skill wave-nirholas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wave
Source: https://github.com/nirholas/three-ui/tree/main/examples/skills/wave
Command: npx skills add https://github.com/nirholas/three-ui --skill wave-nirholas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps the agent communicate friendly, nonverbal acknowledgment during greetings, farewells, and introductions without requiring the user to specify an animation each time.

Core Features & Use Cases

  • Context-triggered waving: Automatically waves when the user greets, says goodbye, or introduces someone.
  • Style adaptation: Selects a wave style (casual, enthusiastic, subtle) that matches the conversational vibe.
  • Tool call execution: Executes wave({ style, duration_ms }) and records the action in memory to avoid repetition in the same turn.

Quick Start

Ask your agent to wave with an enthusiastic style using the wave tool.

Frequently Asked Questions about wave

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

FAQPage Schema
How do I trigger nonverbal wave gestures during real-time agent interactions?

You can trigger nonverbal wave gestures by initiating conversational events like greetings, farewells, or introductions. The agent automatically detects these contexts and plays an appropriate wave animation in the 3D viewer.

Can I select a specific wave style for agent greetings without manual animation input?

Yes, you can select a wave style such as casual, enthusiastic, or subtle. The agent adapts the wave style to match the conversational vibe and executes it without requiring manual animation input.

How do I stop my 3D agent from repeating wave animations in the same conversation turn?

The system prevents repeating wave animations in the same conversation turn through turn-level throttling. It persists a memory note with the chosen style and result to avoid duplicate gestures.

Does the wave tool work without a style-specific GLB clip loaded?

Yes, the wave tool works without a style-specific GLB clip by falling back to hint-based animation playback. This ensures real-time interaction continues smoothly even when specific 3D animation assets are missing.

What is context-aware waving in real-time 3D agent interactions?

Context-aware waving is an automated nonverbal acknowledgment mechanism for real-time 3D agent interactions. It dynamically selects and plays wave animations during greetings, farewells, and introductions to communicate friendly gestures.