gms-mcp

name	gms-mcp
description	GameMaker MCP workflow skills and command reference Use when this capability is needed.
metadata	{"author":"ampersand-game-studios"}

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 name

---

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

---

Converted and distributed by TomeVault — claim your Tome and manage your conversions.