skill CX Codex

msw-avatar — Claude Code skill: MSW costumes and animation

Q: How do I install msw-avatar in Claude Code?

Run `npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-avatar -a claude-code`. The skill file lands at `~/.claude/skills/msw-avatar/SKILL.md`.

Q: What does the skill need to work?

A connected `msw-maker-mcp` server for the `refresh` call, plus `msw-search` to look up RUIDs. Never make an RUID up, and only a plain Guid works in `Custom*Equip` fields.

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓

npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-avatar -a claude-code

Open on GitHub

What msw-avatar 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.

What it helps with

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 for the agent

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

How to install msw-avatar

1Skills CLI (Vercel)

npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-avatar -a claude-code

2Manually: put the files in place

~/.claude/skills/msw-avatar/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/msw-avatar/

1Skills CLI (Vercel)

npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-avatar -a codex

2Manually: put the files in place

.agents/skills/msw-avatar/SKILL.md

For all projects use ~/.agents/skills/

1Skills CLI (Vercel)

npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-avatar -a cursor

2Manually: put the files in place

.cursor/skills/msw-avatar/SKILL.md

Cursor also reads .agents/skills/ and .claude/skills/

1GitHub CLI

gh skill install MSW-Git/msw-ai-coding-plugins-official msw-avatar

2Manually: put the files in place

.github/skills/msw-avatar/SKILL.md

1Skills CLI (Vercel)

npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-avatar -a gemini-cli

2Platform CLI

gemini skills install https://github.com/MSW-Git/msw-ai-coding-plugins-official --path plugins/msw-maker-base-skill/skills/msw-avatar

Manually: put the files in place

.devin/skills/msw-avatar/SKILL.md

The legacy .windsurf/skills/ path still works

Skills CLI (Vercel)

npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-avatar -a opencode

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about msw-avatar

How do I install msw-avatar in Claude Code?

Run npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-avatar -a claude-code. The skill file lands at ~/.claude/skills/msw-avatar/SKILL.md.

What does msw-avatar do?

It lets the agent edit MSW avatar costumes and animation: equipment slots, state-to-clip mapping, custom actions. After editing files it calls refresh on msw-maker-mcp.

What does the skill need to work?

A connected msw-maker-mcp server for the refresh call, plus msw-search to look up RUIDs. Never make an RUID up, and only a plain Guid works in Custom*Equip fields.

orbit-card heygen-com Adds a 10-second 1920×1080 HyperFrames motion block where a single feature card orbits a dot sphere using exported Blender camera paths. CX Codex +1 10,000installs cad earthtojake Builds and edits parametric CAD models, exports STEP, STL, 3MF and GLB, measures geometry, and opens existing files in CAD Viewer. CX Codex +1 14,000installs step-parts earthtojake This skill searches the step.parts catalog for off-the-shelf components and pulls their STEP files, so you stop modeling placeholder geometry. CX Codex +1 11,200installs sdf earthtojake This skill authors and validates SDFormat files for models and worlds, then helps prepare them for simulator handoff. CX Codex +1 10,500installs urdf earthtojake This skill helps create, validate, and debug URDF robot descriptions. Use it when working with links, joints, geometry, meshes, or inertial data. CX Codex +1 10,500installs hatch-pet official openai Creates and packages animated pets and spritesheets for Codex. Use it to turn a character concept, reference image, or brand cues into a pet. CX Codex +1 3,300installs

From the same set10

msw-combat-system Reference guide for the 2D combat pipeline in MSW. Helps implement attack collision, damage calculation, hit reactions, and monster AI. CX Codex +1 9,800installs msw-defaultplayer A skill for editing the DefaultPlayer model in MapleStory Worlds Maker: run speed, jump force, HP, camera and physics, all through ModelBuilder. Handy when the character needs tuning. CX Codex +1 9,800installs msw-scripting Guides authoring .mlua scripts for MapleStory Worlds, covering annotations, execution spaces, and playtesting. Useful when building MSW logic and debugging runtime issues. CX Codex +1 9,900installs msw-general Foundation skill for MapleStory Worlds work: shared tools, platform rules and validated .model templates. Every other MSW skill builds on it. CX Codex +1 9,900installs msw-painter Draws a pixel-art sprite when msw-search finds no suitable RUID, then helps register the PNG as a resource. CX Codex +1 9,700installs msw-behaviourtree Builds MSW .behaviourtree files and refreshes a project-specific node spec. Use it to define a behaviour graph with Blackboard variables and node properties. CX Codex +1 9,600installs msw-sprite-ruid Rules for assigning RUID to SpriteRendererComponent.SpriteRUID and SpriteGUIRendererComponent.ImageRUID, plus the thumbnail:// prefix for icons. CX Codex +1 9,700installs msw-ui-system Guides coding agents through building MapleStory Worlds interfaces: generates .ui layouts, configures UI components, and handles .mlua UUID bindings. CX Codex +1 9,700installs