msw-scripting — Claude Code skill: what it does, how to install
Guides authoring .mlua scripts for MapleStory Worlds, covering annotations, execution spaces, and playtesting. Useful when building MSW logic and debugging runtime issues.
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-scripting -a claude-codeWhat msw-scripting does
The skill directs coding in MapleStory Worlds using .mlua. It enforces platform-specific conventions: @Component, @Logic, @ExecSpace, and @Sync. Applying Unity patterns here will break runtime behavior. For instance, UI scripts run strictly on the client, and singletons use @Logic rather than static manager classes.
New scripts belong in feature-based folders under ./RootDesk/MyDesk/, such as Player/ or Inventory/. Flat folder dumps like Scripts/ are explicitly blocked. The skill requires checking signatures against .d.mlua definitions in ./Environment/NativeScripts/, which tracks 104 components and 46 services. Every edit triggers an LSP check, followed by the Maker MCP refresh command.
What it helps with
- write mlua components using MSW lifecycle annotations
- route client and server logic via ExecSpace RPCs
- verify engine API signatures against NativeScripts definitions
- fix mlua LSP diagnostic errors before running tests
Example prompts for the agent
- Create a MeleeAttackComponent.mlua under Combat/ with a server-side damage handler
- Inspect NativeScripts for SpawnByModelId and implement it in MonsterSpawnerLogic
- Run mlua diagnostics and refresh Maker for modified inventory scripts
How to install msw-scripting
1Skills CLI (Vercel)
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-scripting -a claude-code2Manually: put the files in place
~/.claude/skills/msw-scripting/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/msw-scripting/
1Skills CLI (Vercel)
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-scripting -a codex2Manually: put the files in place
.agents/skills/msw-scripting/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-scripting -a cursor2Manually: put the files in place
.cursor/skills/msw-scripting/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install MSW-Git/msw-ai-coding-plugins-official msw-scripting2Manually: put the files in place
.github/skills/msw-scripting/SKILL.md1Skills CLI (Vercel)
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-scripting -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-scriptingManually: put the files in place
.devin/skills/msw-scripting/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-scripting -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-scripting
How to install msw-scripting in Claude Code?
Run npx skills add MSW-Git/msw-ai-coding-plugins-official --skill msw-scripting -a claude-code in your terminal.
What does msw-scripting do?
It instructs coding agents on .mlua syntax, MSW engine conventions, directory rules, and LSP diagnostic workflows.
Where must method documentation comments be placed in mlua?
Documentation comments must be placed as the first line inside the method body. Placing them above the method causes the mlua parser to bind them to the preceding declaration.