PlugWiki

MSW General skill for Claude Code: the foundation for MapleStory Worlds projects

The foundation skill for MapleStory Worlds (MSW) that makes Claude follow platform rules and use builders before it edits a world.

Installs
10.2K
on skills.sh
Stars
38
on GitHub
Files
59
besides SKILL.md
Updated
Oct 2026
last repo commit

msw-general is the first skill to load in a MapleStory Worlds (MSW) project. Its description says to read it first, and its text says every other MSW skill depends on it. It makes Claude read the entity guide before touching entities, check the map's TileMapMode before map work, use builders for .map, .model and .ui files, and never leave SpriteRUID empty.

The folder holds 60 files, including 34 .model templates and 3 Node builder scripts. It also lists the Maker MCP tools Claude can call, such as play, stop, refresh and logs.

Good for

  • Creators building a MapleStory Worlds game with Claude Code
  • Anyone using the other msw-* skills, which all depend on this one
  • Developers who need Claude to respect map modes, builders and refresh rules

Install msw-general

Claude Code

  1. 1

    Copy this prompt.

    Install the msw-general skill in Claude Code. Run this command:

npx skills add https://github.com/msw-git/msw-ai-coding-plugins-official --skill msw-general --skill msw-scripting --skill msw-ui-system --skill msw-search

Then check that it loaded and tell me how to use it.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

The plugin route installs msw-maker-base-skill: 13 skills (counted from the git tree) and hooks (6 hook events backed by 12 Node scripts, per hooks.json and the git tree). Read the permissions section first. The skills CLI route copies only the skill folders named, without the hooks. SKILL.md for msw-general says every other MSW skill depends on it, so it is always in the list, plus msw-scripting, msw-ui-system, msw-search which this skill sends you to. The skills also call two MCP servers, msw-maker-mcp and msw-mcp. SKILL.md points to the official setup page for wiring them and the API key: https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1368 The default shown is the skills CLI route, which does not add the hooks.

Built from the package data we hold. Not yet tested by us. Source.

What's in the skill

When it loads

Foundation skill for MSW (MapleStory Worlds). Read this FIRST before anything else in MSW.

Sections in SKILL.md

  1. Core Principle: Visual Polish
  2. When making a .model — catalog first
  3. Placing multiple entities — model first
  4. Preflight read semantics — applies to every "MUST Read" in this skill
  5. Entity Work Preflight — MUST
  6. Builder Protocol Preflight — MUST
  7. Model Work Preflight — MUST
  8. Map Work Preflight (do this BEFORE any map work)
  9. Recommending the right mode — MUST when starting a new map or when the current mode is clearly wrong for the user's goal
  10. Changing TileMapMode — user action in Maker, not an AI file edit
  11. Platform Rules Preflight — MUST when any of these triggers fire
  12. 8 Core Rules (must memorize)
  13. MCP Tool Quick Reference (msw-maker-mcp)
  14. Per-task routing — which reference to read
  15. Absolute Principles (apply to every task)

Key facts

Author
MSW-Git, the marketplace owner in marketplace.json; the README calls the repo the public release source for MSW maker skills
License
No LICENSE file in the repo and none in the plugin manifests; GitHub shows no license
Installs on skills.sh
10,240 as of Nov 2, 2026
GitHub stars
38 for the msw-ai-coding-plugins-official repo, Nov 2, 2026
What is inside
60 files including SKILL.md: 20 Markdown, 34 .model, 3 .map and 3 .cjs builder scripts (git tree)
Part of
The msw-maker-base-skill plugin, which holds 13 skills (git tree)
Works with
Names msw-search, msw-scripting and msw-ui-system as skills to load alongside it
Last commit to the repo
Oct 6, 2026
Needs
A MapleStory Worlds local workspace, Node.js for the bundled scripts, and the Maker MCP servers set up as described in the official docs

What it includes

  • Never leave SpriteRUID empty; find sprites with msw-search

    After Claude creates an entity, it must find matching sprites, animations and sounds and apply their RUIDs. SKILL.md says working logic alone is not finished.

    Write · Visual polish rule

  • Starts a new .model from a validated template

    The skill folder has 34 .model templates for monsters, NPCs, players and terrain. Claude loads the closest one through ModelBuilder instead of writing from an empty file.

    Try: “Make a chasing monster and place five of them on the map.”

    Write · Model catalog first

  • Entity, builder protocol, model, map and platform guides

    Preflights tell Claude which reference to read in full before entity, builder, model, map or platform-rule work. Files already in context are not re-read.

    Read · Preflight reads

  • Reads MapComponent.TileMapMode with MapBuilder

    The three modes need different Body components. SKILL.md says Claude must never change TileMapMode by editing the file. It asks you to switch in Maker's Hierarchy, then refreshes.

    Read · Map mode check

  • Short list of silent-failure causes

    Covers mode and Body mismatch, the .mlua plus .codeblock pair, empty SpriteRUID, SpawnByModelId parent, 100 pixels per world unit, RootDesk only, read-only .d.mlua and CoreVersion.

    Read · 8 core rules

  • maker_get_current_map, play, stop, refresh, logs and more

    Lists play, stop, refresh, logs, clear_logs, screenshot (only on request), keyboard_input, mouse_input and maker_execute_script. refresh is not allowed during play.

    Runs code · Maker MCP tool reference

  • Node scripts that edit structured files

    This folder bundles map, model and collision-group-set builder scripts. SKILL.md says .model and .ui files are builder-only and .map is builder-first.

    Runs code · Builders for .map, .model and .ui

  • Table of reference files by task

    Points to workspace, platform, troubleshooting, authoring, tile, entity, model, monster, animation-state, material and dataset guides.

    Read · Per-task reference routing

From the official docs

Permissions

Medium risk

This skill lets Claude edit your MapleStory Worlds files and drive the Maker editor through MCP, and the plugin route adds hooks that write files and log calls. Work on a copy under version control and read the hook findings before installing the plugin.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • It can run your game in Maker and send input

    SKILL.md lists play, stop, keyboard_input, mouse_input and maker_execute_script, which runs a script inside the running game. Watch the first runs. github.com

  • It edits and can delete world files

    .model and .ui changes go through builder scripts, and SKILL.md gives a node command that deletes a file because the builders have no delete call. Use version control. github.com

  • The plugin runs 9 hook scripts on 6 events

    hooks.json registers 9 hook scripts on 6 events. SessionStart: mlua-session-start.cjs starts the mlua LSP daemon in the background when it finds a RootDesk folder, and inject-agents-md.cjs (next item). UserPromptSubmit: skill-router-reminder.cjs adds the same fixed routing reminder to every prompt. PreToolUse: skill-read-guard.cjs refuses Bash reads such as cat, head or grep on the plugin's skill .md files, and structured-file-guard.cjs refuses reads, edits and shell commands on .model and .ui files. PostToolUse on Edit, Write and MultiEdit: mlua-diagnose-post-tool-use.cjs runs the mlua checker on edited .mlua files and returns a block decision with the errors when it finds any, and a second hook calls the msw-maker-mcp tool maker_refresh_workspace. PostToolUse on Read and Skill, and the InstructionsLoaded event: skill-log.cjs logs skill reads to .mswai/logs/skill.log. PostToolUse on every tool: mcp-log.cjs (below). SessionEnd: mlua-session-end.cjs stops the LSP daemon. Use the skills CLI route in the install box if you do not want hooks. github.com

  • The plugin writes AGENTS.md and edits CLAUDE.md

    inject-agents-md.cjs copies its AGENTS.md to your project root, replacing the file if the content differs, and adds an @AGENTS.md line at the top of CLAUDE.md. Back up an existing AGENTS.md first. github.com

  • The plugin runs a downloaded package with npx -y

    The mlua checks start a background daemon at session start and run again after each .mlua edit. resolve-cmd.cjs looks first for a local copy (env override, the workspace .mswai/runtime folder, the ai-cli vendored copy, mlua-lsp on PATH). If none is found and npx exists, it runs npx -y @maplestoryworlds/mlua-lsp@1.1.4, which downloads that package from the npm registry. github.com

  • The plugin logs every MCP call to .mswai/logs

    mcp-log.cjs runs after every tool call and, for MCP tools from any server, appends one line to .mswai/logs/mcp.log in your project with the tool name, the full arguments and the full response (cut only if MCP_LOG_MAX_OUTPUT_BYTES is set). lsp.log and skill.log are written to the same folder. Our advice: add .mswai/ to .gitignore, because the log can hold anything your MCP servers return. github.com

  • The plugin blocks direct reads of .model and .ui files

    structured-file-guard.cjs refuses Read, Edit, Write and shell commands on .model and .ui files and tells Claude to use the builders. Setting MSW_STRUCTURED_FILE_GUARD_DISABLE=1 turns it off. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details
Turning on read-onlySKILL.md names no read-only setting.
Scopes

  • Edits .map, .model, .ui and .mlua files in your MSW workspace through builders

  • Calls Maker MCP tools: play, stop, refresh, logs, screenshot, keyboard_input, mouse_input, maker_execute_script

  • Bundles 3 Node builder scripts

Questions

What does the msw-general skill do?

It is the foundation skill for MapleStory Worlds work. It gives Claude platform rules, preflight reads, builder rules and the Maker MCP tool list, so edits to a world do not silently break.

Do the other MSW skills need it?

Yes. SKILL.md says every other MSW skill depends on it, and the other skills read its reference files and builders. Install it with any msw-* skill.

How do I install it?

Use the install box above. The skills CLI route copies msw-general and the skills it points to. The plugin route installs all 13 skills in the msw-maker-base-skill plugin and its hooks.

Is it official, made by Nexon?

The repo does not say so. It is published by a personal GitHub account named MSW-Git (account type User, no company or description on the profile). The repo name contains "official" and the README calls it the public release source for MSW maker skills, but nothing in the repo names Nexon as the publisher. marketplace.json lists the owner as MSW-Git with an outlook.kr email address. The skills do link to Nexon's MapleStory Worlds creators docs for MCP setup. Our advice: treat it as a third-party toolkit for Nexon's platform unless Nexon confirms otherwise.

Do I need the MapleStory Worlds MCP servers?

The skills call two MCP servers, msw-maker-mcp for the Maker editor and msw-mcp for search and assets. SKILL.md says to point you to the official setup page when an MCP call fails or an API key is needed: https://maplestoryworlds-creators.nexon.com/ko/docs?postId=1368.

Will Claude change my map mode?

No. SKILL.md says Claude must never change TileMapMode by editing the .map file. It recommends a mode, asks you to switch it in Maker's Hierarchy, then refreshes and fixes Body components.

Is msw-general safe to use?

It lets Claude edit your world files through builders, run scripts, and drive the Maker editor through MCP, including play, stop and input simulation. The plugin route also adds hooks, so read the permissions section before you install it. Our advice: work on a copy of your workspace and use version control.

Information

updated Nov 2, 2026

Repository
msw-git/msw-ai-coding-plugins-official
Folder
plugins/msw-maker-base-skill/skills/msw-general

msw-git/msw-ai-coding-plugins-officialskills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 15
  1. msw-ai-coding-plugins-official README · github.com
  2. marketplace.json · github.com
  3. msw-general SKILL.md · github.com
  4. skills.sh listing · skills.sh
  5. MSW-Git GitHub profile · github.com
  6. hooks.json · github.com
  7. inject-agents-md.cjs · github.com
  8. resolve-cmd.cjs · github.com
  9. mcp-log.cjs · github.com
  10. structured-file-guard.cjs · github.com
  11. skill-router-reminder.cjs · github.com
  12. mlua-diagnose-post-tool-use.cjs · github.com
  13. skill-log.cjs · github.com
  14. skill-read-guard.cjs · github.com
  15. mlua-session-start.cjs · github.com

Updated Nov 2, 2026.