avatar

Bridge persona visual and audio rendering to external avatar runtimes.

45|5|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/acnlabs/OpenPersona --skill avatar-acnlabs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: avatar
Source: https://github.com/acnlabs/OpenPersona/tree/main/layers/faculties/avatar
Command: npx skills add https://github.com/acnlabs/OpenPersona --skill avatar-acnlabs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Provides a lightweight bridge that offloads avatar rendering, animation, and voice to external runtimes so personas can have visual and audio embodiment without bundling rendering engines.

Core Features & Use Cases

  • External runtime integration: discovers runtime capabilities, starts sessions, and routes text/audio to avatar providers.
  • State synchronization: maps runtime status into appearanceState, visualManifest, and control payloads for persistence and UI consumption.
  • Graceful fallback and model resolution: resolves model3 URLs from persona packs, environment overrides, or runtime defaults and degrades to text-only when runtimes are unavailable.
  • Use Case: In a live demo, start an avatar session for a persona, sync appearance state to the persona pack, and render a demo canvas with the provider's image or model.

Quick Start

Ask the agent to show your avatar to start the external avatar runtime and sync the persona's appearance state.

Frequently Asked Questions about avatar

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

FAQPage Schema
How do I integrate external avatar runtimes with persona workflows?

To integrate external avatar runtimes, you need a bridge that discovers runtime capabilities and routes text or audio to avatar providers for live sessions. This allows personas to achieve visual and audio embodiment without bundling rendering engines.

How does persona appearance state synchronization work with 3D models?

Appearance state synchronization maps runtime status into appearanceState, visualManifest, and control payloads. This process enables local persistence and UI consumption by syncing the visual state directly from the avatar provider to the persona pack.

What happens to avatar rendering when external runtimes are unavailable?

When external runtimes are unavailable, the system provides graceful fallback by degrading to text-only. It also handles model URL resolution from persona packs or environment defaults to attempt rendering before failing over.

How do I start an avatar session for a live demo?

To start an avatar session for a live demo, ask the agent to show your avatar. This initiates the external avatar runtime, resolves the model3 URL, and syncs the persona's appearance state to render a demo canvas.

Can I use this to map runtime status into control payloads for persistence?

Yes, you can map runtime status into control payloads for local persistence. The bridge routes sensory status and appearance state patches to sync visual manifestation data for UI consumption and persona pack updates.