gms-mcp
GameMaker MCP workflow skills and command reference
Resources
2Install
npx skillscat add ampersand-game-studios/gms-mcp/gms-mcp Install via the SkillsCat registry.
SKILL.md
GMS-MCP Skills
Task-oriented workflows and comprehensive command reference for GameMaker development.
Workflows
Task-focused guides for common GameMaker development tasks.
Creating Things
| Workflow | Task |
|---|---|
| setup-object | Create object with sprite and events |
| setup-script | Create script with JSDoc |
| setup-room | Create room with layers and instances |
| orchestrate-macro | Create multi-asset systems |
Modifying Things
| Workflow | Task |
|---|---|
| smart-refactor | Rename asset with reference updates |
| duplicate-asset | Copy asset to create variant |
| update-art | Replace sprite images |
| manage-events | Add, remove, validate events |
Deleting Things
| Workflow | Task |
|---|---|
| safe-delete | Check dependencies before deletion |
Understanding Code
| Workflow | Task |
|---|---|
| find-code | Find definitions and references |
| lookup-docs | Look up GML function documentation |
| analyze-logic | Understand script behavior |
| generate-jsdoc | Document functions |
Running & Debugging
| Workflow | Task |
|---|---|
| run-game | Compile and run the game |
| debug-live | Send commands to running game |
Project Health
| Workflow | Task |
|---|---|
| check-health | Quick project validation |
| check-quality | Detect code anti-patterns |
| cleanup-project | Fix orphans and sync issues |
| pre-commit | Validate before committing |
Reference
Comprehensive command documentation for when you need syntax details.
| Reference | Contents |
|---|---|
| asset-types | All 14 asset types, options, naming conventions |
| event-types | Event specifications, key codes |
| room-commands | Room, layer, instance operations |
| workflow-commands | Duplicate, rename, delete, swap |
| maintenance-commands | All maintenance operations |
| runtime-options | Platforms, VM/YYC, bridge |
| symbol-commands | Index, find, list operations |
| doc-commands | GML documentation lookup, search, cache |
Quick Commands
# Create
gms asset create object o_name --parent-path "folders/Objects.yy"
gms asset create script scr_name --parent-path "folders/Scripts.yy"
gms event add o_name create
# Run
gms run start
gms run stop
# Find
gms symbol find-definition name
gms symbol find-references name
# Docs
gms doc lookup draw_sprite
gms doc search collision
gms doc list --category Drawing
# Health
gms diagnostics --depth quick
gms maintenance auto --fix
# Delete safely
gms symbol find-references name # Check first!
gms asset delete type nameInstallation
gms skills install # Install to ~/.claude/skills/
gms skills install --project # Install to ./.claude/skills/
gms skills install --openclaw # Install to ~/.openclaw/skills/
gms skills install --openclaw --project # Install to ./skills/
gms skills list # Show installed skillsCategories
Install
npx skillscat add ampersand-game-studios/gms-mcp/gms-mcp Install via the SkillsCat registry.