shinshin86

Mesh Avatar Studio — Development skill for Claude Code

Development community

Turn one illustration into an animated 2D mesh avatar with a coding agent and a local editor.

How to install Mesh Avatar Studio

This entry records only its repository, not the path inside it, so there is no exact command to give. Open shinshin86/mesh-avatar-studio and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Mesh Avatar Studio does

Turn one illustration into an animated 2D mesh avatar with a coding agent and a local editor.

Alternatives in Development

  • Ship Studio — The professional studio for modern development — build it, ship it, host it without leaving the app 249 ★
  • 07b Numerical Simulation — Stage 7b: Numerical Simulation and Computational Illustration (OPTIONAL — USER-CONTROLLED) 164 ★
  • Openhop Flow — Render an animated OpenHop flow diagram for the prompt that follows 41 ★

README

Mesh Avatar Studio

[日本語](README.ja.md)

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.

![The editor with the Miko sample](docs/images/en/01-overview.png)

Try the sample

Requires Node.js 22.17+.

npm install
npm run dev

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.

How it works

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.

1. Ask your agent to create the avatar

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](docs/agent-guide.md): 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//`, 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.

![The request for a new avatar](docs/images/en/06-new-project.png)

Recommended setups:

Agent Model
Claude Code Claude Opus 5.5
Codex GPT-6.1 Sol

2. Open the project and check it

Start the editor (`npm run dev`), choose **Open project** and pick your project from the list. In the preview, use **Pose test** to turn and tilt the head and close the