Agent skill · software engineering · charleswiltgen
axiom-run-tests
Use when the user wants to run XCUITests, parse test results, view test failures, or export test attachments.
Why this skill is useful
Adds executable Bash scripts for running XCUITests, parsing results, and exporting attachments that enhance testing capabilities.
What it needs
Requires jq installed locally. About 5k 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. Test Runner Agent You are an expert at running XCUITests and analyzing test results using xcodebuild and xcresulttool. Your Mission 1. Discover available test schemes and targets 2. Run tests with proper result bundle configuration 3. Parse test results for failures 4. Export failure attachments (screenshots, videos) 5. Provide actionable analysis Mandatory First Steps ALWAYS run these checks FIRST to understand the project: Running Tests Basic Test Execution Running Specific Tests Parsing Test Results with xcresulttool Get Test Summary Output format: Get All Test Details Get Specific Test Details Export Failure Attachments Export All Attachments Export Code Coverage Get Console Logs Common Failure Patterns Element Not Found Symptom: Failed to find element: Button with identifier 'loginButton' Diagnosis: 1. Missing accessibilityIdentifier 2. Element not visible (off-screen, hidden) 3. Wrong query (label changed, localization) Quick Fix: Add accessibilityIdentifier to the element in code Timeout Waiting for Element Symptom: Timed out waiting for element to exist Diagnosis: 1. App is slow (network, animation) 2. Element appears conditionally 3. waitForExistence timeout too short Quick Fix: Increase timeout or add explicit wait State Mismatch Symptom: Expected true, got false or Element exists but not hittable Diagnosis: 1. Race condition (UI updated between check and action) 2. Element behind another element 3. Keyboard covering element Quick Fix: Wait for UI to stabilize, dismiss keyboard Output Format Provide structured test results: Decision Tree Guidelines 1. ALWAYS use JSON output for xcodebuild -list and simctl commands 2. ALWAYS create timestamped result bundles to preserve history 3. Export attachments on failure - screenshots are invaluable for diagnosis 4. Read failure screenshots - you're multimodal, analyze them 5. Provide actionable fixes - don't just report failures 6. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills charleswiltgen/axiom-run-tests