ios-qa

Run vision-driven QA loops on real iPhones via USB CoreDevice tunnels.

Updated May 11, 2026
One-click install
npx skills add https://github.com/cloudofgeorge/AI-hands --skill ios-qa-cloudofgeorge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ios-qa
Source: https://github.com/cloudofgeorge/AI-hands/tree/main/skills/gstack/ios-qa
Command: npx skills add https://github.com/cloudofgeorge/AI-hands --skill ios-qa-cloudofgeorge

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Live-device QA for SwiftUI apps on real iPhones, enabling automated verification of UI flows, performance, and reliability by driving a vision-based agent loop and capturing live device feedback.

Core Features & Use Cases

  • Live real-device testing: Connects to a physical iPhone via USB, reads Swift source to understand every screen, and runs a vision-driven agent loop: screenshot → analyze → decide → act → verify → repeat.
  • StateServer-assisted verification: Uses an embedded StateServer to coordinate tests and validations, with optional remote access over a tunnel (e.g., via Tailscale) for cross-environment QA.
  • Plan-mode safety & telemetry: Includes plan-mode safe operations and telemetry prompts to ensure deterministic, auditable testing workflows.

Quick Start

Connect a real iPhone via USB and run the iOS QA loop against your SwiftUI app.

Frequently Asked Questions about ios-qa

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

FAQPage Schema
How do I automate real-device iOS QA for SwiftUI apps?

Automated real-device iOS QA for SwiftUI apps connects to a physical iPhone via USB, reads Swift source code to map screens, and runs a vision-driven agent loop of screenshot, analyze, decide, act, and verify to test UI flows.

How does vision-driven UI testing work on a physical iPhone?

Vision-driven UI testing works by capturing screenshots from a physical iPhone connected via USB, analyzing the visual state, deciding on an action, executing it, and verifying the result in a continuous agent loop.

Can I run remote QA on a real iPhone over a network tunnel?

Yes, you can run remote QA by exposing the embedded StateServer over a network tunnel like Tailscale, allowing cross-environment testing and verification on a real iPhone.

Do I need to connect my iPhone via USB to run automated SwiftUI testing?

Yes, connecting an iPhone via USB is required to establish the CoreDevice IPv6 tunnel, which enables the vision-driven agent loop to capture screenshots and execute actions on the physical device.

How does the StateServer assist in iOS UI verification?

The StateServer assists iOS UI verification by loading operational instructions and coordinating the testing loop, ensuring that actions and validations against the live device are predictable and auditable.

What is plan-mode safety in automated iOS testing?

Plan-mode safety in automated iOS testing enforces deterministic, auditable workflows by constraining the agent loop's actions and incorporating telemetry prompts to keep test execution predictable.