ios-qa

Automate iOS QA on real iPhones by analyzing screenshots and Swift source.

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/sadie100/claude-dotfiles --skill ios-qa-sadie100
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ios-qa
Source: https://github.com/sadie100/claude-dotfiles/tree/main/skills/ios-qa
Command: npx skills add https://github.com/sadie100/claude-dotfiles --skill ios-qa-sadie100

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gstack, vision-driven-agent, and includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill automates Live-device iOS QA for SwiftUI apps, saving time and effort by detecting bugs and issues on real iPhones.

Core Features & Use Cases

  • Live Device Testing: Connects to a real iPhone via USB and performs vision-driven QA.
  • Swift Source Analysis: Reads Swift source code to understand every screen.
  • Vision-Driven Agent Loop: Takes screenshots, analyzes them, and repeats the process.
  • Remote Access: Optionally exposes the device over Tailscale for remote testing.
  • Use Case: Use this Skill when asked to "ios qa", "test my iPhone app", "find bugs on the device", or "qa the iOS app".

Quick Start

To run the ios-qa skill, use the command: /ios-qa

Frequently Asked Questions about ios-qa

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

FAQPage Schema
How do I automate iOS QA testing for a SwiftUI app on a real device?

Automate iOS QA for SwiftUI apps by connecting a real iPhone via USB, analyzing Swift source code to understand screens, and running a vision-driven agent loop that captures and evaluates screenshots to detect bugs.

How does vision-driven testing find bugs in an iPhone app?

Vision-driven testing identifies bugs by capturing screenshots of your SwiftUI app on a connected iPhone, then using an automated agent to visually analyze the screen states and detect UI issues or unexpected behaviors.

Do I need a USB connection to run automated QA on an iOS app?

Yes, a USB connection to a real iPhone is required to run this automated iOS QA process, though the device can optionally be exposed over Tailscale for remote testing access.

Can I use a vision-driven agent to test my Swift source code?

Yes, the testing agent reads your Swift source code to understand every screen in your SwiftUI app before executing vision-driven test loops on a live device to find bugs.

What are the limitations of using live-device iOS QA for SwiftUI apps?

This live-device iOS QA approach requires a physical USB connection to an iPhone and depends on vision-driven agents, meaning it cannot run on emulators and requires the specific gstack and vision-driven-agent dependencies to function.