by shinshin86
Turn one illustration into an animated 2D mesh avatar with a coding agent and a local editor
From $49 · 30 days · terms & refunds
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM lists this project for discovery and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
Automated security scan — not a certification.
# Add to your Claude Code skills
git clone https://github.com/shinshin86/mesh-avatar-studioGuides for using ai agents skills like mesh-avatar-studio.
Last scanned: 10/5/2026
{
"issues": [
{
"type": "npm-audit",
"message": "@vitest/mocker: Vitest: Path Traversal / Arbitrary File Read via @vitest/mocker Redirect Mock",
"severity": "medium"
},
{
"type": "npm-audit",
"message": "vitest: Vulnerability found",
"severity": "medium"
}
],
"status": "PASSED",
"scannedAt": "2026-10-05T11:13:05.950Z",
"npmAuditRan": true,
"pipAuditRan": true,
"promptInjectionRan": true
}See how mesh-avatar-studio compares with popular alternatives.
Turn a single illustration into an animated 2D mesh avatar: it blinks, talks, turns its head, breathes and sways its hair. A coding agent prepares the avatar from your image; you fine-tune it in a local editor with a live preview.
See it move on the landing page. To move it with your own face and voice without installing anything, open the Player in Chrome or Edge.

Requires Node.js 22.17+ and Git.
npx create-mesh-avatar-studio
cd mesh-avatar-studio
npm run dev
The first command downloads the repository, installs its packages and checks the tools
Studio needs. If you cloned the repository yourself, run npm install, then
npm run doctor for the same check. Only Node.js is needed for the editor and the Live
page. uv and Python rebuild layers, and Playwright Chromium renders the motion review when
an agent creates an avatar; the check warns about each one that is missing.
Open the URL printed in the terminal (for example http://127.0.0.1:5173/). The editor opens
the bundled sample, Miko in a qipao. Pick a part on the left, drag its dots on the image and
watch the preview on the right. The sample is read-only; when you change it, choose
Copy and keep editing to continue in your own copy.
Use git clone to download the repository when possible. If you use a ZIP, open its
Properties in File Explorer and select Unblock, if shown, before extracting it.
Create projects/ yourself under your Windows account before asking an agent to work in it
(npx create-mesh-avatar-studio creates it for you).
Folders created by another account or an agent running in a sandbox can have permissions
that prevent the editor from reading them. If a project cannot be read, use the folder's
Properties → Security settings to grant your account access to the whole project,
including its files and subfolders through permission inheritance.
Making an avatar from your own illustration takes four steps. Steps 1 and 4 are done by a coding agent (Claude Code or Codex) working in this repository; steps 2 and 3 happen in the editor.
Open Claude Code or Codex in this repository folder and give it your illustration:
Create an avatar from this image following docs/agent-guide.md:
/path/to/your-image.png
The agent follows the agent guide: it checks how accurately it reads
coordinates, places the rig on zoomed grids, cuts the image into layers and reviews the
avatar in fixed poses. The project is saved in projects/<name>/, which is never committed.
Best results come from a front-facing, head-and-shoulders PNG with a transparent background.
When no project is open, the editor shows this request ready to copy.

Recommended setups:
| Agent | Model |
|---|---|
| Claude Code | Claude Opus 5.5 |
| Codex | GPT-6.1 Sol |
With the Codex CLI installed and signed in, one command creates the project, has Codex follow the agent guide without questions and opens the editor on the result:
npm run create -- /path/to/your-image.png
Codex also draws closed eyes, mouth shapes and expressions with OpenAI image generation, and
first closes an open mouth in the illustration so the avatar rests with it closed. This sends
the image and masks to OpenAI, so the command asks first; add --yes to agree in advance, or
--no-variants to keep everything on your machine. It usually takes tens of minutes. Codex writes its notes to projects/<name>/HANDOVER.md. It runs with
--approve-for-me, so its requests to run tools outside its sandbox, such as Chromium for the
pose review, are reviewed automatically instead of by you. npm run create -- --help lists the
options.
Without an illustration, --random has Codex draw a new anime-style girl first and builds the
avatar from her. Her looks are chosen at random; --prompt describes what you want instead,
and --seed repeats the same random choices. The drawing is kept in work/random/, and the
choices in projects/<name>/work/character.json.
npm run create -- --random
npm run create -- --random --prompt "silver short hair, school uniform"
Send one illustration to an agent with its own cloud computer, such as Dot, Muse or Grok Bot, and ask it to create an avatar and, where supported, a page you can open on your phone. See Create an avatar with a cloud agent for a message to copy and what has been tried.
Start the editor (npm run dev), choose Open project and pick your project from the list.
The pencil next to a project renames it, together with its folder under projects/.
If the avatar has overlay layers such as glasses (built/overlays/), the preview lists them
under Overlays so you can switch them on and off.
In the preview, use Pose test to turn and tilt the head and close the eyes. In Lip sync,
choose a mouth style and try it with kana text. Open Fine-tune to adjust movement, size
and closing, or preview a local audio file.

Select a part on the left. Its dots are highlighted on the image; drag them to fix the placement. The preview follows your changes immediately. Some values also decide how the image is cut into layers: eye and hand outlines, and the head, hair and bun areas used for the hair mask. After changing those, a banner appears; choose Save and rebuild layers there. It takes a few seconds.


Zoom with a pinch or Ctrl/Cmd+scroll, pan with two fingers or by dragging empty space, and use Fit selected part to jump to the current part.
Without drawings, the eyes and mouth move by mesh deformation alone. Drawn closed eyes and vowel mouths make blinking and talking look much more natural. In Drawn variants, check Eyes, Mouth or both, copy the message and paste it into Codex opened in this repository folder. Codex draws them with its built-in image generation and imports them; the editor reloads them automatically. (Claude Code cannot generate images; its message prepares the masks and prompts for you to hand to an image generator.)
Expressions is optional: it adds drawn sad and surprised eyes and closed angry and sad mouths. The avatar switches to them for those expressions and emotion tags and still blinks and speaks; avatars without them look the same as before.

Choose Export .mavatar in the editor to download one file containing the saved rig, built layers, drawn expressions and avatar metadata. Include source image is on by default so the recipient can edit it in Studio. If you have unsaved edits, use Save and export; changed outlines need a layer rebuild first. Read-only views export the original files.
In Open project, choose Import .mavatar or drop the file there. Studio creates a new
folder under projects/, using a new name if one already exists. Import requires npm run dev
and accepts archives up to 128 MiB. Without the source image, the imported avatar can play but
cannot be edited or rebuilt. Omitting the source does not remove the built images.
See the avatar format for the file contents.

Open your project in the editor and choose Live. Start the camera, face forward with relaxed eyes and a closed mouth, then choose Calibrate. You can adjust mirroring, sensitivity and smoothing, or enable microphone lip sync. Camera video and microphone audio stay on your machine; only numeric avatar motion values reach the stream view.
Track body movement (experimental) is off by default. While it is off, only the face is tracked, as before. When it is on, Live also uses visible shoulders, hips, elbows and wrists, and lists what the loaded avatar follows: the upper body always, legs and arms only when its rig sets them up. Body points from a webcam are less stable than the face, so expect some extra sway, especially in skirts and other cloth. See Full-body tracking.
Choose a background and Copy OBS URL, or Open stream view in a new tab to check it first. Keep the Live page open and add the URL as an
OBS Browser Source, for example at 1080 × 1080. The transparent background works
directly in OBS. For other capture software, choose green and apply a chroma key.
Both pages use the local development server (npm run dev). The stream view shows idle
motion when the Live page stops sending updates.
Optional Lighting adds shading that follows a light you drag over the avatar. It is off by default; open its section near the bottom of the Live page, or below the preview in the editor. The OBS URL includes the lighting settings. See Lighting.
If the avatar has overlay layers such as glasses (built/overlays/), the Overlays section
of the Live page switches them on and off. The stream view follows at once, and the OBS URL
includes the overlays that are shown.
Keep the Live page open in its own window. Open the OBS URL inside OBS or in another tab; do not paste it into the tab running Live. If the page reports that tracking has stopped or slowed whil
mesh-avatar-studio is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by shinshin86. Turn one illustration into an animated 2D mesh avatar with a coding agent and a local editor. It has 2,440 GitHub stars.
Yes. mesh-avatar-studio passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/shinshin86/mesh-avatar-studio" and add it to your Claude Code skills directory (see the Installation section above).
mesh-avatar-studio is primarily written in TypeScript. It is open-source under shinshin86 on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh mesh-avatar-studio against similar tools.
No comments yet. Be the first to share your thoughts!