gms-mcp — independently scanned and version-tracked by SaferSkills.
SaferSkills independently audited gms-mcp (Agent Skill) and scored it 100/100 (green). The audit ran 55 deterministic rules across Security, Supply Chain, Maintenance, Transparency, and Community; it found 0 high-severity and 0 lower-severity findings. The full rule-by-rule trace and per-finding evidence are below. Free, methodology-open.
Findings & checks · 0 flagged
Every scanned point with the score it earned and what moved between them.
First recorded scan — no prior version to compare against.
The primary manifest — the file an agent reads to learn what this artifact does.
Use this skill when working on a local GameMaker project containing a .yyp file. GMS MCP gives an assistant structured tools to understand and change game assets, navigate GML, diagnose project issues, compile and run the game, and interact with supported live-game commands through an optional TCP bridge.
This is the workflow skill pack for GMS MCP by Ampersand Game Studios, an independent, open-source game-development tool, not an official GameMaker product. It is not a project-management or social-media service. The package includes an MCP server and the standalone gms CLI; installing this skill alone does not install or connect the server or grant editing permissions.
| Task | Tools and workflows |
|---|---|
| Understand game code | Inspect assets and metadata, find GML definitions and references, explore dependency graphs, and look up GML documentation. |
| Create and edit content | Create assets, manage object events, place room instances, and edit room layers. |
| Refactor and maintain | Preview reference-aware renames and deletions, diagnose missing references, and repair resource integrity when requested. |
| Build and run | Compile and launch through GameMaker's Igor toolchain, manage run sessions, and select installed runtimes. |
| Inspect a running game | Use supported bridge commands and logs emitted through __mcp_log(); this is not arbitrary GML evaluation, hot reload, or automatic IDE synchronization. |
For package installation and client configuration, follow the project quick start. Use an MCP-capable client such as Cursor, Codex, or Claude Code, or use the CLI without an AI client. The Claude Code plugin is optional.
Before choosing a workflow:
gm_capabilities and gm_project_info to check the connected project, active profile, and available tools. Do not infer a live connection from configuration files alone.command -v gms gms-mcp finds both executables, then run gms-mcp doctor --project from the game's project directory. Building and running require an installed GameMaker runtime and appropriate licence/access credentials; project inspection does not require the IDE to be running.safe profile. Editing and builds require explicitly configured standard/full access and any relevant optional toolsets. Do not change the profile merely to satisfy a read-only request; MCP profiles do not restrict the standalone CLI.Read the workflow relevant to the task below, then its command reference when needed. Bridge work also requires the bridge setup guide.
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 |
| 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.
Comprehensive command documentation for when you need syntax details.
| Reference | Contents |
|---|---|
| asset-types | 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 workflow safe-delete --asset-type type --asset-name name # Dry-run
gms workflow safe-delete --asset-type type --asset-name name --apply # Applygms 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~30 seconds. Free. No account. Every finding cites a rule and a line of evidence.