Moufa Xingyun Avatar
给任意 Agent 接上一个魔珐星云(Xmov)实时 3D 数字人前端——网页里 new 一个数字人,把 Agent 的文字输出喂给 speak(),它就实时说话、配口型、做动作。当用户想"给 Agent / 聊天机器人 / LLM 加一个会说话的虚拟形象、数字人、虚拟主播、3D avatar 前台",或要接入魔珐星云 / 星云 / Xmov / XmovAvatar SDK 时使用本技能。
Install
npx skills add lewislulu/moufa-xingyun-avatar --skill moufa-xingyun-avatargit clone --depth 1 https://github.com/lewislulu/moufa-xingyun-avatar.git /tmp/moufa-xingyun-avatar
mkdir -p ~/.claude/skills
cp -r /tmp/moufa-xingyun-avatar/. ~/.claude/skills/moufa-xingyun-avatarPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# 魔珐星云数字人前端接入(开发指南)
把一个**只会回文字的 Agent**,升级成一个**会说话、有口型表情动作的 3D 数字人前台**。
核心闭环:`用户提问 → Agent 生成文字 → 数字人 speak() 实时表达`。你只负责给文字,SDK 负责语音/口型/表情/动作。
## 何时用本技能
- 用户要给 Agent / LLM / 客服 / 导览 / 讲解场景加一个**可实时交互的虚拟形象**。
- 用户提到:魔珐星云 / 星云 / Xmov / XmovAvatar / 具身驱动 / 数字人 SDK。
- 用户已有一个返回文本的 Agent 后端,想把输出"说"出来并配上形象。
---
## STEP 0 —— 先问凭证(没有就跑不起来,务必第一步问清)
在写任何代码前,**先向用户索取以下两项**,缺一不可:
1. **`appId`**(应用 ID)
2. **`appSecret`**(应用密钥)
获取方式(可一并告诉用户):登录**魔珐星云官网 → 应用中心 → 创建「具身驱动应用」**,创建后即可看到该应用的 `appId` 与 `appSecret`。数字人的**形象 / 音色 / 表演风格在后台按 appId 配好**,所以 SDK 默认**不需要**你在代码里再传形象配置。
拿到后**不要硬编码进前端文件或公开仓库**,放进服务端环境变量(见 STEP 1)。
> ⚠️ 安全提醒,主动告知用户:该 SDK 的设计是 `appSecret` 在**浏览器侧**初始化时传入(见下),因此 secret 会出现在客户端。务必:
> - 只用服务端注入(`/config.js`),不写进 git;
> - 一旦通过公网/隧道/录屏暴露过,**到后台轮换 appSecret**。
---
## 关键事实 / 踩坑(务必遵守,都是实测血泪)
1. **构造后必须 `await avatar.init()`** —— 漏了它只建实例、**不下载、不连接、不渲染**,你会对着空屏发懵。**这是最常见的坑。**
2. **默认不要下发 `config`** —— 形象配置在后台按 appId 自动拉取。若把别的账号的 `look_name`/`figure_name` 等塞进 `config`,生产网关会直接拒:`Error 1: ttsa request error: 不支持的配置`。**只有当你确知是本账号的真实资源时**才传 config(见「多形象切换」)。
3. **`appSecret` 走客户端**(浏览器侧 new 时就要传)。见 STEP 0 的安全处理。
4. **`speak(text, isStart, isEnd)`** 三参数:内容、是否本轮开始、是否本轮结束。
- 一次说完:`speak(t, true, true)`
- 流式:首块 `speak(t, true, false)`、中间 `speak(t, false, false)`、收尾 `speak('', false, true)`
5. **状态机**:`idle / listen / think / speak / interactive_idle / offlineMode`。
用户说话→`listen()`,处理中→`think()`,回答→`speak()`,答完回 `interactive_idle`。Details
- Skill name
moufa-xingyun-avatar- Repository
- lewislulu/moufa-xingyun-avatar
- Repo updated
- 1 June 2026
FAQ
What does the Moufa Xingyun Avatar skill do?
给任意 Agent 接上一个魔珐星云(Xmov)实时 3D 数字人前端——网页里 new 一个数字人,把 Agent 的文字输出喂给 speak(),它就实时说话、配口型、做动作。当用户想"给 Agent / 聊天机器人 / LLM 加一个会说话的虚拟形象、数字人、虚拟主播、3D avatar 前台",或要接入魔珐星云 / 星云 / Xmov / XmovAvatar SDK 时使用本技能。
How do I install the Moufa Xingyun Avatar skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add lewislulu/moufa-xingyun-avatar --skill moufa-xingyun-avatar. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Moufa Xingyun Avatar popular?
It lives in lewislulu/moufa-xingyun-avatar, which has 11 GitHub stars and 1 forks.
Related skills
Seedance 25 Prompting
9gbeyrouti/seedance-prompting-claude-skill
Expert prompt engineering pour Seedance 2.5 (ByteDance / Dreamina / Jimeng / Doubao), modèle vidéo 30 s en une passe, audio natif, 50 références max. Utiliser dès que l'utilisateur veut écrire, optimiser ou déboguer un prompt Seedance (2.5 ou 2.0), générer une vidéo avec Seedance/Dreamina/Jimeng, faire du text-to-video, image-to-video, first/last frame, multi-keyframes, storyboard, blockout ou clay render, utiliser des références @Image/@Video/@Audio, éditer ou étendre une vidéo, une transition seamless, du multi-plans timecodé, du dialogue lip-syncé (notamment en français) ou une vidéo longue
Doctor
11SomeStay07/claude-doctor-skill
Audits any project for security, test coverage, and Claude Code automation. 46 checks across 6 layers: secrets, CLAUDE.md, hooks, skills, agents, rules, MCP, CI, memory. Adaptive scoring — auto-detects project maturity (Starter/Growing/Mature/Pro). Diagnoses gaps, prescribes project-specific fixes, applies them. Usage: /doctor — full audit (all 6 layers) /doctor quick — TOP-3 priorities + score (30 seconds) /doctor scan — diagnose only (no changes) /doctor fix — prescribe + apply fixes /doctor layer <N> — audit specific layer (0-5) /doctor verify — health check Triggers: "/doctor", "audit", "s
Wise Men Flash
9Ali-expandings/wise-men-flash
Use when the user asks for a "flash council", "quick council", "fast panel", "wise men flash", "quick second opinion from a panel", or invokes /wise-men-flash — and when they want a council-quality answer to a hard question fast (four subagent calls and about a third of the full council's time, a median 16.7 minutes in its own pre-registered round) rather than the full wise-men protocol. A three-member council of a practitioner anchor named for the job the question belongs to, one domain member, and a Devil's Advocate — each reasoning down a different path, spawned in parallel. No peer-review
Coursiv AI
11alphaparkinc/coursiv-ai-skill
Learn practical AI skills step-by-step through beginner-friendly, habit-forming lessons, structured challenges (1-week, 4-week, 12-week), and role-specific workflows (Marketing, Real Estate, Remote Jobs).
Agency Icm Builder
12krsnczky/agency-icm-builder
Build or audit an AI-runnable workspace for a client-service agency (marketing, PPC, design, consulting, dev shops). Folder structure does the orchestration - one agent, routing files, per-client folders, session capture. Use when the user wants to (1) set up an agency workspace an AI agent can operate ("build me an agency workspace", "structure my agency for AI"), (2) audit an existing agency folder against these conventions ("audit my workspace", "why does my agent keep mixing up clients"), or (3) restructure a grown-wild agency folder into this shape ("restructure this", "ICM my agency").
Agentic Commerce Protocol (ACP)
11alphaparkinc/openclaw-agentic-commerce-protocol
Modular agentic commerce skill for implementing OpenAI & Stripe's Agentic Commerce Protocol. Enables AI agents to negotiate capabilities, initiate checkout sessions, handle secure Stripe Payment Token (SPT) delegation, and process fulfillment events.
Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.