ios-game-testing

Automate SpriteKit iOS game testing via the GameCommandServer HTTP API.

4|Updated Nov 29, 2025
One-click install
npx skills add https://github.com/ruarfff/Nathaniel --skill ios-game-testing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ios-game-testing
Source: https://github.com/ruarfff/Nathaniel/tree/main/.claude/skills/ios-game-testing
Command: npx skills add https://github.com/ruarfff/Nathaniel --skill ios-game-testing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Skill provides automated testing for the Nathaniel SpriteKit iOS game using the embedded GameCommandServer HTTP API, reducing manual QA time and ensuring features behave correctly in the simulator.

Core Features & Use Cases

  • Automated UI Interaction: Use GameCommandServer API (port 8765) for deterministic, coordinate-accurate testing of the SpriteKit game.
  • End-to-End Test Steps: Build, run, health check, state inspection, and scripted actions to validate features end-to-end.
  • Test Scenarios: Navigate from Main Menu to Level Select, start a level, toggle characters, move units, target enemies, and verify camera behavior.
  • Visual Verification: Obtain screenshots via the API or XcodeBuildMCP tooling for visual QA.

Quick Start

Build and run the game in a simulator, then use the GameCommandServer API to drive tests. For example:

  • Start the simulator and app
  • Wait for the server to be healthy at http://localhost:8765/health
  • Retrieve the current game state with http://localhost:8765/state
  • Perform actions via http://localhost:8765/action with a JSON payload like {"name":"startGame"}