Test the Nathaniel iOS game in simulator. Use when asked to test the game, verify changes work, run sanity tests, check if a feature works, or when the user says "test this", "run the game", "verify it works", "check in simulator".
The ios-game-testing skill is designed to streamline and automate the testing of the Nathaniel iOS game within a simulator environment. It addresses the challenges of reliably verifying game behavior in landscape-oriented SpriteKit games, where traditional UI automation tools can have coordinate transformation issues. By leveraging the embedded GameCommandServer HTTP API, this skill allows testers to interact with the game directly through scene coordinates rather than screen coordinates, ensuring more accurate and consistent results during gameplay testing and feature verification.
Key features of the ios-game-testing skill include building and running the game in an iOS simulator, setting up session defaults, and accessing the GameCommandServer for health checks, game state queries, node inspection, and executing named actions. Testers can navigate menus, select levels, move characters, target enemies, and capture screenshots for visual verification. The skill also provides commands to interact with all tappable elements, retrieve scene information, and manipulate game objects programmatically, which enhances testing efficiency and reduces human error.
This skill is ideal for iOS game developers, QA engineers, and automated testing specialists who need to perform sanity checks, verify new features, or run regression tests on the Nathaniel game. It is especially useful for testing complex interactions in landscape SpriteKit games where traditional UI tools fall short. Typical use cases include verifying game mechanics, checking feature functionality, capturing visual evidence of gameplay states, and ensuring the game operates correctly on the latest iOS simulator versions. By using this skill, users can ensure a more robust, reliable, and automated testing workflow for their iOS game projects.
The skill supports iOS 26.1+ simulators, including devices such as the iPhone 17 Pro. Ensure the simulator version meets the minimum requirement for proper functionality.
Interactions should be performed through the GameCommandServer HTTP API using named actions, taps at scene coordinates, and retrieving game state or nodes. UI interaction tools from XcodeBuildMCP are not recommended for landscape games.
Yes, screenshots can be captured using the XcodeBuildMCP screenshot command or via the GameCommandServer API to visually confirm game states.
If the health check returns an error, the app may not have fully launched. Wait a few seconds and retry the request until the server reports a healthy status.
This skill is optimized for SpriteKit games in landscape mode and provides reliable interactions through the GameCommandServer. It is not intended for general UI automation where XcodeBuildMCP UI tools may still be required.
Quick Setup:
.claude/skills/Repository
ruarfff/Nathaniel