axiom-run-tests

Execute XCUITests with xcodebuild and analyze xcresult bundles for failures.

34|2|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/DengNaichen/Stet --skill axiom-run-tests
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: axiom-run-tests
Source: https://github.com/DengNaichen/Stet/tree/main/.agents/skills/axiom-run-tests
Command: npx skills add https://github.com/DengNaichen/Stet --skill axiom-run-tests

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires jq.

What problem does it solve?

This skill automates the complex process of running iOS XCUITests, parsing result bundles, and diagnosing failures, which typically requires manual interaction with Xcode and command-line tools.

Core Features & Use Cases

  • Automated Test Execution: Runs test schemes on booted simulators with proper result bundle configuration.
  • Failure Diagnosis: Automatically parses xcresult bundles to identify specific test failures and extract console logs.
  • Artifact Export: Extracts screenshots and videos from failed tests to provide visual evidence for debugging.
  • Use Case: When a CI/CD pipeline or local test run fails, use this skill to quickly isolate the failing test method, view the failure screenshot, and receive an actionable analysis of the error.

Quick Start

Use the axiom-run-tests skill to run the main test scheme and analyze any failures found in the latest result bundle.

Frequently Asked Questions about axiom-run-tests

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate XCUITest execution and failure analysis from the command line?

You can automate XCUITest execution and failure analysis by using xcodebuild to run tests and xcresulttool to parse result bundles. This workflow automatically isolates failing test methods, extracts console logs, and exports failure screenshots for debugging.

What is the best way to parse xcresult bundles to extract test failure screenshots?

Parsing xcresult bundles to extract test failure screenshots involves using xcresulttool to inspect the bundle structure and jq for JSON parsing. This approach automatically identifies specific test failures and exports visual debugging artifacts like screenshots and videos.

Do I need jq installed to analyze XCUITest results from xcodebuild?

Yes, you need jq installed to analyze XCUITest results because it is required for parsing the JSON output generated by xcresulttool. You also need a properly configured Xcode environment with available booted simulators to run the tests.

Can I run XCUITest schemes on booted simulators without opening Xcode?

Yes, you can run XCUITest schemes on booted simulators without opening Xcode by using xcodebuild for automated test execution. This allows you to configure result bundles and run UI tests entirely from the command line for CI/CD workflows.

Why does my automated iOS UI test failure diagnosis lack visual debugging evidence?

Automated iOS UI test failure diagnosis lacks visual debugging evidence when xcresult bundles are not properly parsed for artifacts. Using xcresulttool to extract screenshots and videos from failed tests provides the necessary visual evidence to isolate and debug errors.