run-tests

Automate end-to-end Xcode test execution with configurable parallelization strategies.

49|9|Updated Feb 16, 2026
One-click install
npx skills add https://github.com/Terryc21/xcode-workflow-skills --skill run-tests-terryc21
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: run-tests
Source: https://github.com/Terryc21/xcode-workflow-skills/tree/main/skills/run-tests
Command: npx skills add https://github.com/Terryc21/xcode-workflow-skills --skill run-tests-terryc21

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates end-to-end Xcode test execution with configurable parallelization strategies.

Core Features & Use Cases

  • Supports Smart Split (UI sequential + unit parallel)
  • Offers All Sequential and All Parallel modes for stability or speed
  • Includes an unattended mode for hands-off runs in CI

Quick Start

Choose a strategy and run the appropriate workflow to start tests.

Frequently Asked Questions about run-tests

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

FAQPage Schema
How do I automate Xcode unit and UI tests with parallel execution?

Automate Xcode test execution by configuring a scheme, simulator destination, and test targets, then selecting a parallelization workflow. This runs unit and UI tests automatically without manual intervention.

What is the best way to run UI tests sequentially while running unit tests in parallel?

Use the Smart Split workflow to run UI tests sequentially and unit tests in parallel simultaneously. This strategy balances the stability of UI tests with the speed of parallel unit testing.

Do I need XcodeBuildMCP to run unattended Xcode test workflows?

Yes, unattended Xcode test runs require XcodeBuildMCP and Bash alongside a properly configured scheme, simulator destination, and test targets to execute successfully without manual input.

Can I run all my Xcode tests sequentially instead of using parallel testing?

Yes, you can select the All Sequential workflow to execute Xcode tests sequentially. This mode prioritizes stability over speed by avoiding parallel execution entirely.

How does unattended mode work for Xcode test automation in CI?

Unattended mode enables hands-off Xcode test execution for CI environments by running configured parallelization strategies automatically. It requires a fully configured scheme and simulator destination to operate.

When should I choose All Parallel over Smart Split for Xcode testing?

Choose All Parallel to maximize test execution speed when test stability is not a concern. Smart Split is better when UI tests require sequential execution to avoid state conflicts.