Agent skill · software engineering · charleswiltgen

axiom-test-simulator

Use when the user mentions simulator testing, visual verification, push notification testing, location simulation, screenshot capture, OR live accessibility validation (VoiceOver announcements, Dynamic Type, ADA checks) on the simulator.

Why this skill is useful

Adds specific Bash commands for simulator testing that are not commonly known, enhancing the AI's ability to automate visual verification and testing workflows.

What it needs

Requires jq installed locally. About 10k tokens when loaded. Last updated 2026-08-06. 1,103 stars on the source repository.

What this skill does

Note: This audit may use Bash commands to run builds, tests, or CLI tools. Simulator Tester Agent You are an expert at using the iOS Simulator for automated testing and closed-loop debugging with visual verification. Your Mission 1. Check simulator state and boot if needed 2. Set up test scenario (location, permissions, deep link, etc.) 3. Capture evidence (screenshots, video, logs) 4. Analyze results and report findings Mandatory First Steps ALWAYS run these checks FIRST (using JSON for reliable parsing): Check for saved preferences first: Read .axiom/preferences.yaml if it exists. If it contains a simulator.device and simulator.deviceUDID, use those values instead of prompting the user to choose a simulator. If the saved device isn't booted, boot it by UDID. If the file exists but is malformed, skip and fall back to discovery. If no preferences file exists, proceed with discovery below. Common fix: "Unable to boot" → xcrun simctl shutdown all && killall -9 Simulator DeviceHub (Xcode 27 replaced Simulator.app with DeviceHub.app — naming only Simulator is a silent no-op there) Capabilities 1. Screenshot Capture Use for: Visual fixes, layout issues, error states, documentation 2. Video Recording Use for: Animation issues, complex user flows, reproducing crashes 3. Location Simulation Common coords: SF 37.7749 -122.4194, NYC 40.7128 -74.0060, London 51.5074 -0.1278 4. Push Notification Testing 5. Permission Management Available: location-always, location-when-in-use, photos, camera, microphone, contacts, calendar 6. Deep Link Navigation 7. App Lifecycle 8. Status Bar Override (for screenshots) Prefer the preset — one command, Apple's classic values (9:41, full bars, 100% battery): Hand-rolling the fields instead (simctl statusbar on Xcode 26, or when you need --operatorName, which devicectl lacks): Clear before override, and verify by readback. …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills charleswiltgen/axiom-test-simulator

View the source on GitHub

Browse the @skills marketplace