ios-qa

Automate end-to-end iOS QA on real devices via CoreDevice IPv6 tunnel.

1|Updated May 27, 2026
One-click install
npx skills add https://github.com/mi179/claude-skills --skill ios-qa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ios-qa
Source: https://github.com/mi179/claude-skills/tree/main/user/gstack/ios-qa
Command: npx skills add https://github.com/mi179/claude-skills --skill ios-qa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Live-device iOS QA for SwiftUI apps. Connects to a real iPhone via USB CoreDevice IPv6 tunnel, reads Swift source to understand every screen, then runs a vision-driven agent loop: screenshot → analyze → decide → act → verify → repeat. All interaction happens via HTTP to an embedded StateServer in the app under test. Optionally exposes the device over Tailscale so remote agents (OpenClaw, Codex, any HTTP-capable agent) can run iOS QA from anywhere without touching the hardware. Use when asked to "ios qa", "test my iPhone app", "find bugs on the device", or "qa the iOS app". (gstack) Voice triggers (speech-to-text aliases): "iOS quality check", "test the iPhone app", "run iOS QA".

Core Features & Use Cases

  • Vision-driven on-device QA: reads app screens to guide automated testing.
  • Real-device access: runs tests against a connected iPhone or iPad.
  • Remote agent compatibility: exposes the device over Tailscale for off-device QA.

Quick Start

Initialize the iOS QA workflow by connecting a real device, starting the embedded StateServer, and running the ios-qa plan.

Frequently Asked Questions about ios-qa

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

FAQPage Schema
How do I run automated iOS QA on a real iPhone?

Remote iOS QA works by exposing the connected device over Tailscale, allowing HTTP-capable agents to securely run tests from anywhere without direct physical access to the hardware.

How does vision-driven testing work for SwiftUI apps?

Vision-driven testing works by reading Swift source code to understand screens, then capturing screenshots to analyze application state and automatically decide, act, and verify UI interactions during testing.

Can I use remote agents to test my iPhone app without touching the hardware?

Yes, you can use remote agents to test an iPhone app by exposing the device over Tailscale, which allows HTTP-capable agents to execute iOS QA workflows remotely without touching the hardware.

Do I need Tailscale to run live device testing?

You do not need Tailscale for local live device testing, but it is required to expose the device securely to remote agents and enforce access controls with rotated tokens and per-tailnet endpoint rules.

What security controls are enforced during remote iOS device testing?

Remote iOS device testing enforces security through rotated tokens, per-tailnet endpoint rules, and strict routing gates to control agent access and protect the connected hardware during QA sessions.