msw-general — Claude Code skill: MapleStory Worlds foundation
Foundation skill for MapleStory Worlds work: shared tools, platform rules and validated .model templates. Every other MSW skill builds on it.
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-general -a claude-codeWhat msw-general does
This skill sets the shared groundwork for MapleStory Worlds: how to find resources, how to author .model and .map files, which platform rules to follow. Other MSW skills reference it, so it comes first.
Inside is a catalog of validated .model templates grouped by category: monsters, NPCs, player, terrain, map objects, particles, sound, tile maps, UI. Starting a new .model from an empty file is discouraged — pick the closest template, swap the three identifiers (EntryKey, Id, Name) through ModelBuilder, then adjust components. Save into a typed subfolder of RootDesk/MyDesk/Models/, for example Models/Monsters/{Name}.model, then refresh.
There is a separate rule for repeated objects: if the same entity shows up in a map twice or more, author a .model and place instances by modelId instead of copy-pasting @components. One edit in the model updates every instance, and the .map stays readable. Dynamic spawning through SpawnByModelId needs a model regardless of count. Before touching entities the skill requires reading references/entity.md; before editing .map, .model or .ui it requires the builder protocol.
What it helps with
- build a monster or NPC
.modelfrom a ready template - place five identical trees via
modelIdinstead of copy-paste - match a sprite and animation to an entity's role
- wire hit effects and interaction sounds
- keep model and map instances from drifting apart
Example prompts for the agent
- read msw-general and build a
.modelfor a chasing monster - use msw-general to place 10 trees via
modelIdin this map - check with msw-general that every entity has
SpriteRUIDset
How to install msw-general
1Skills CLI (Vercel)
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-general -a claude-code2Manually: put the files in place
~/.claude/skills/msw-general/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/msw-general/
1Skills CLI (Vercel)
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-general -a codex2Manually: put the files in place
.agents/skills/msw-general/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-general -a cursor2Manually: put the files in place
.cursor/skills/msw-general/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install MSW-Git/msw-ai-coding-plugins-official msw-general2Manually: put the files in place
.github/skills/msw-general/SKILL.md1Skills CLI (Vercel)
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-general -a gemini-cli2Platform CLI
gemini skills install https://github.com/MSW-Git/msw-ai-coding-plugins-official --path plugins/msw-maker-base-skill/skills/msw-generalManually: put the files in place
.devin/skills/msw-general/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-general -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about msw-general
How do I install msw-general in Claude?
Run npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-general -a claude-code. The skill lands at ~/.claude/skills/msw-general/SKILL.md.
What does msw-general do?
It provides the shared layer for MapleStory Worlds work: a catalog of .model templates, rules for placing entities, and the reading order for reference docs. Other MSW skills depend on it.
When do I need a model instead of inline components?
A one-off entity in a single map can use inline components. At two or more instances the skill requires a .model with modelId instances.