macos-game-testing

The macos-game-testing skill is designed to facilitate the testing of the Nathaniel SpriteKit game on macOS. It solves the problem of testing macOS builds by leveraging the GameCommandServer HTTP API to interact with the game, perform tests, and verify changes. Unlike iOS simulators, macOS SpriteKit games do not have reliable external UI automation tools, which is why this skill focuses on interacting directly with the game through the GameCommandServer API. This allows testers to perform various actions such as navigating menus, interacting with gameplay, and taking screenshots without relying on the traditional UI automation tools.

The skill primarily supports testing features through HTTP API calls, which include retrieving the game state, interacting with in-game elements, and executing named actions. Key functions include navigating through the game menus, retrieving interactive nodes, performing clicks based on custom scene coordinates, and obtaining screenshots. XcodeBuildMCP is used for building, running, and stopping the game app, while GameCommandServer handles interactions with the game itself. This skill provides a streamlined and automated approach to testing, ensuring consistency and reliability across different builds.

Target users of this skill include quality assurance (QA) engineers, game developers, and testers who need to automate macOS game testing. It is particularly useful for teams developing SpriteKit games on macOS, enabling them to test gameplay features, check for bugs, and ensure the game works as intended after each build. With its simplicity and direct interaction with the game, it offers a reliable solution for macOS game testing that integrates smoothly into a development workflow.