Gms mcp

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

MCP Prompt Catalogue

Prompt	Outcome	Related workflow
create-feature	Build a scoped feature with organized assets and verification	setup-object, setup-script, setup-room, orchestrate-macro
diagnose-project	Establish a focused, evidence-backed project diagnosis	check-health, check-quality, analyze-logic
safe-refactor	Change code or assets without losing references or structure	smart-refactor, safe-delete
compile-fix-retry	Fix an actual compiler failure and rerun verification	run-game, check-health
inspect-live-game	Inspect supported live-game state without arbitrary evaluation	debug-live

All MCP prompts are read-only templates: fetching one does not inspect or modify a project. Follow its linked workflow for command detail. For all implementation work, initialize required fields during setup, avoid GameMaker reflective *_exists probes, and place new assets under an intended folder rather than the project root.

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 workflow safe-delete --asset-type type --asset-name name          # Dry-run
gms workflow safe-delete --asset-type type --asset-name name --apply  # Apply

---

Installation

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 skills