PlugWiki

MSW Packages skill for Claude Code: reuse official MapleStory Worlds feature packages

A MapleStory Worlds skill that makes Claude check a catalog of prebuilt feature packages before building a feature from scratch.

Installs
10.1K
on skills.sh
Stars
38
on GitHub
Updated
Oct 2026
last repo commit

msw-packages is a thin index of the MSWPackages repository, which SKILL.md calls the official MSW first-party set of prebuilt feature packages. Before Claude writes a standard feature, it matches your request against a table of 20 packages, then fetches the package README from GitHub and asks whether to integrate it.

Integration means copying files into your project, checking UUID collisions and RUIDs, and installing dependent packages first. SKILL.md says the default is to ask you before integrating.

Good for

  • MapleStory Worlds creators who need a shop, inventory, quest or ranking system
  • Developers who want to reuse tested code instead of writing it again
  • Teams who want to avoid ID collisions when copying packages

Install msw-packages

Claude Code

  1. 1

    Copy this prompt.

    Install the msw-packages skill in Claude Code. Run this command:
    
    npx skills add https://github.com/msw-git/msw-ai-coding-plugins-official --skill msw-packages --skill msw-general --skill msw-ui-system --skill msw-scripting
    
    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-ui-system, msw-scripting 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

MSWPackages catalog — official 1st-party prebuilt packages for common MSW features. Use this skill BEFORE writing a feature from scratch when the user asks for any standard game system (toast/notification, ranking/leaderboard, inventory/equipment, shop/store, world shop, mail, quest/achievement, dialog/NPC conversation, key binding, game event broadcast, player data/save, collection/dex, slash command, scrollview/virtualized list, drop table, global config, GM message, resource/currency, UI components). Always check the catalog first; if a package matches the requested feature, fetch its README and propose integrating instead of building from zero. Keywords: MSWPackages, package, prebuilt, integration.

Sections in SKILL.md

  1. Decision Flow
  2. Feature → Package Mapping
  3. Scope-First Routing (UI vs System)
  4. Routing rule
  5. When to skip the question
  6. Fetch Protocol
  7. 1. README first (always)
  8. 2. File tree (when integration is likely)
  9. 3. Raw file fetch (per-file as needed)
  10. Integration Workflow
  11. Pitfalls
  12. When the user has already chosen "build from scratch"
  13. When MSW-Git/MSWPackages is unreachable
  14. Cross-references

Key facts

Installs on skills.sh
10,090 as of Nov 2, 2026
Last commit to the repo
Oct 6, 2026

What it includes

  • Match request to package, then ask

    No match means normal MSW authoring. A match means Claude summarizes the README and asks whether to integrate or build from scratch.

    Read · Decision flow

  • 20 packages

    Includes toast, ranking, inventory, shop, world shop, mail, quest and achievement, dialog, key binding, game events, player data, collection and more.

    Try: “Add a shop and an inventory to my world.”

    Read · Feature to package table

  • System features versus UI-only requests

    UI-only requests go to msw-ui-system and its templates instead of a package.

    Read · Scope-first routing

  • README, file tree and raw files from GitHub

    Fetches raw.githubusercontent.com and api.github.com URLs for MSW-Git/MSWPackages. If GitHub is unreachable, Claude tells you and builds from scratch.

    Network · Fetch protocol

  • Copy files, check UUIDs and RUIDs, refresh

    Maps Core files into RootDesk/MyDesk, ui and Models folders, regenerates colliding UUIDs, installs dependent packages first, then stop, refresh and play.

    Runs code · Integration workflow

  • .modpackage, Sample folders, bulk installs

    SKILL.md says .modpackage files are not installers, Sample content is not for copying unless asked, and packages should be installed one at a time.

    Read · Pitfalls

From the official docs

Permissions

Medium risk

This skill fetches package code from GitHub and copies it into your project, and the plugin route adds hooks. Read the package README and scripts before you confirm, 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 copies third-party scripts into your project

    Package scripts then run in your game. SKILL.md says to ask before integrating and to read the README first. Read the Core scripts and check for hard-coded RUIDs. 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.
Talks toraw.githubusercontent.com and api.github.com (MSW-Git/MSWPackages)
Scopes
  • Fetches README and source files from GitHub (MSW-Git/MSWPackages)

  • Copies scripts, UI and model files into your workspace

  • Calls Maker MCP stop, refresh and play after integrating

Questions

What does the msw-packages skill do?

It makes Claude check the MSWPackages catalog before it builds a standard game feature, such as a shop, inventory, quest log or ranking, and offer to integrate a matching package.

Does it install packages without asking?

SKILL.md sets the default posture to ask you before integrating, because packages can collide with existing UUIDs, RUIDs or names. Integration steps start after you confirm.

Where do the packages come from?

From the GitHub repository MSW-Git/MSWPackages, fetched on demand. The skill stores only an index, so the catalog stays current.

How do I install it?

Use the install box above. The skills CLI route also installs msw-general, msw-ui-system and msw-scripting.

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. SKILL.md itself calls MSW-Git/MSWPackages "the official MSW first-party repository", which is the same account's claim. Our advice: treat it as a third-party toolkit for Nexon's platform unless Nexon confirms otherwise.

What if I want to build from scratch?

Say so. SKILL.md tells Claude to skip integration and not keep nudging you toward packages.

Is msw-packages safe to use?

It fetches files from GitHub and copies them into your project, including scripts, models and UI files. The plugin route also adds hooks, so read the permissions section before you install it. Our advice: read the README and the Core scripts before you confirm.

Information

updated Nov 2, 2026

Folder
plugins/msw-maker-base-skill/skills/msw-packages

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-packages 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.