# msw-avatar

A skill for MSW avatars: 17 equipment slots, mapping animation states onto sprite clips, and custom actions such as shoot or dance.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 9800 installs · ★ 38
- Author: MSW-Git
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/MSW-Git/msw-ai-coding-plugins-official/tree/HEAD/plugins/msw-maker-base-skill/skills/msw-avatar/SKILL.md
- Updated: 2026-10-06
- HTML: https://affpapa.org/en/nevibecode/skills/msw-avatar

## What it does

The skill treats an MSW avatar on two axes. Appearance lives in `CostumeManagerComponent`; motion comes from `AvatarStateAnimationComponent` together with `AvatarRendererComponent`. Edits go straight into workspace files, and then the `msw-maker-mcp` server is asked to run `refresh` so the editor shows the new state. Which file you touch depends on the target: `./Global/DefaultPlayer.model` for the player, an inline block inside `./map/{mapName}.map` for a placed NPC or monster, a separate `.model` when the entity is bound by `modelId` alone.

All 17 `Custom*Equip` string fields are documented next to the matching `MapleAvatarItemCategory` values, quirks included. `Longcoat` covers both top and bottom, for instance. Item RUIDs are not invented here: they come from `msw-search`, since a made-up identifier binds nothing. The `Custom*Equip` slots take a bare Guid, and a prefixed form such as `thumbnail://<ruid>` gets dropped silently, leaving the slot empty. Worth remembering when equipment refuses to show up.

On the animation side the skill walks through the three-layer chain and four separate key forms: `State`, `AvatarBodyActionStateName`, the `MapleAvatarBodyActionState` enum and a sprite action ID like `swingO1` or `shoot1`. Two mapping systems exist, driven by `IsLegacy`, `ActionSheet` and `StateToAvatarBodyActionSheet`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-avatar -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/msw-avatar/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/msw-avatar/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-avatar -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/msw-avatar/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-avatar -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/msw-avatar/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install MSW-Git/msw-ai-coding-plugins-official msw-avatar
```

2. **Manually: put the files in place**
- File: `.github/skills/msw-avatar/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-avatar -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/MSW-Git/msw-ai-coding-plugins-official --path plugins/msw-maker-base-skill/skills/msw-avatar
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/msw-avatar/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-avatar -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/MSW-Git/msw-ai-coding-plugins-official/tree/HEAD/plugins/msw-maker-base-skill/skills/msw-avatar/SKILL.md

## When to use it
- give an NPC a costume without writing code
- read what a player currently wears via `GetEquip`
- tie a custom action to an animation state
- stop auto-transition on a character
- add a weapon-specific attack motion

## Example prompts
- List the items this NPC has equipped and swap its cape for a new RUID from `msw-search`
- Create a custom dance action and wire it to a state through `StateToAvatarBodyActionSheet`
- Disable auto-transition on this monster so only my clip plays

## Similar
- [3D AI Agent Avatar](https://affpapa.org/en/nevibecode/mcp/3d-ai-agent-avatar.md) — MCP server · ★ 250
- [avatar-video](https://affpapa.org/en/nevibecode/skills/avatar-video.md) — skill · 1100 installs
- [flyworks-avatar-video](https://affpapa.org/en/nevibecode/skills/flyworks-avatar-video.md) — skill · 374 installs
- [ai-avatar-video](https://affpapa.org/en/nevibecode/skills/prime-skills-ai-avatar-video.md) — skill · 379900 installs
- [p-video-avatar](https://affpapa.org/en/nevibecode/skills/p-video-avatar.md) — skill · 12300 installs
- [anime-avatar-generation](https://affpapa.org/en/nevibecode/skills/anime-avatar-generation.md) — skill · 427 installs

From the same set: [msw-git/msw-ai-coding-plugins-official](https://affpapa.org/en/nevibecode/by/msw-git/msw-ai-coding-plugins-official.md) — 14 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md