skills/gms-mcp/SKILL.md
GameMaker MCP workflow skills and command reference
npx skillsauth add ampersand-game-studios/gms-mcp gms-mcpInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Task-oriented workflows and comprehensive command reference for GameMaker development.
Task-focused guides for common GameMaker development tasks.
| 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 |
| 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 |
| Workflow | Task | |----------|------| | safe-delete | Check dependencies before deletion |
| Workflow | Task | |----------|------| | find-code | Find definitions and references | | lookup-docs | Look up GML function documentation | | analyze-logic | Understand script behavior | | generate-jsdoc | Document functions |
| Workflow | Task | |----------|------| | run-game | Compile and run the game | | debug-live | Send commands to running game |
| 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 | | release-promote | Promote dev through pre-release to main |
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 |
# 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
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
tools
Use when work should span one or more detached tasks but still behave like one job with a single owner context. TaskFlow is the durable flow substrate under authoring layers like Lobster, ACPX, plugins, or plain code. Keep conditional logic in the caller; use TaskFlow for flow identity, child-task linkage, waiting state, revision-checked mutations, and user-facing emergence.
tools
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
tools
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
tools
A CLI tool for making authenticated requests to the X (Twitter) API. Use this skill when you need to post tweets, reply, quote, search, read posts, manage followers, send DMs, upload media, or interact with any X API v2 endpoint.