xcuitest-skill — скилл для Claude Code: тесты iOS в Swift
Генерирует UI-тесты на XCUITest для iOS и iPadOS приложений. Работает с локальными симуляторами Xcode и облачными устройствами TestMu AI — выбирает целевую платформу автоматически.
MIT 248 установок ★ 393 обновлён 2026-10-13
npx skills add LambdaTest/agent-skills --skill xcuitest-skill -a claude-codeЧто делает xcuitest-skill
Скилл помогает писать тесты на Swift с использованием Apple's XCUITest — встроенного фреймворка для UI-автоматизации на iOS. Внутри готовые паттерны: запуск приложения, поиск элементов по accessibility identifier, тапы и свайпы, проверки существования элементов, обработка системных алертов. Есть примеры Page Object паттерна для чистого кода и anti-pattern таблица (спит вместо ожидания, жёсткие координаты вместо accessibility ID).
Скилл определяет контекст выполнения: если упомянуть «TestMu», «LambdaTest», «cloud», он генерирует код для загрузки .ipa и test runner, управления реальными устройствами через API. Если говорить про «simulator», «Xcode», «local» — пишет команды для локального запуска через Test Navigator или xcodebuild. По умолчанию работает с локальным симулятором.
Поддерживает Swift и Objective-C, интегрируется со всеми упомянутыми платформами AI-кодинга. Требует установленный Xcode и понимание структуры iOS проекта.
Какие задачи решает
- Написать UI-тесты для экранов авторизации и навигации на iOS
- Настроить работу с облачной фермой реальных устройств TestMu
- Проверить поведение приложения при разных состояниях (инвалидные данные, таймауты)
- Организовать тесты по Page Object паттерну
- Запустить тесты через xcodebuild в CI/CD пайпе
Примеры запросов агенту
- Напиши XCUITest для логина с проверкой валидных и невалидных учётных данных
- Сгенерируй тесты на облачных iOS устройствах TestMu для приложения MyApp.ipa
- Напиши тест, который тапает кнопку, ждёт экрана дашборда и проверяет текст приветствия
Как установить xcuitest-skill
1Через Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill xcuitest-skill -a claude-code2Вручную: положить файлы
~/.claude/skills/xcuitest-skill/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/xcuitest-skill/
1Через Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill xcuitest-skill -a codex2Вручную: положить файлы
.agents/skills/xcuitest-skill/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill xcuitest-skill -a cursor2Вручную: положить файлы
.cursor/skills/xcuitest-skill/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install LambdaTest/agent-skills xcuitest-skill2Вручную: положить файлы
.github/skills/xcuitest-skill/SKILL.md1Через Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill xcuitest-skill -a gemini-cli2Командой платформы
gemini skills install https://github.com/LambdaTest/agent-skills --path xcuitest-skillВручную: положить файлы
.devin/skills/xcuitest-skill/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add LambdaTest/agent-skills --skill xcuitest-skill -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о xcuitest-skill
Как установить xcuitest-skill в Claude Code?
Выполни команду npx skills add LambdaTest/agent-skills --skill xcuitest-skill -a claude-code, затем открой файл ~/.claude/skills/xcuitest-skill/SKILL.md для проверки установки.
Что делает xcuitest-skill?
Генерирует готовые UI-тесты на XCUITest для iOS-приложений: примеры авторизации, поиска элементов, действий (тапы, свайпы), проверок. Автоматически выбирает контекст — локальный симулятор или облачные устройства TestMu.
Какая разница между локальным тестированием и TestMu cloud?
Локально тесты запускаются в симуляторе Xcode на машине разработчика (команда xcodebuild). На TestMu тесты загружают .ipa и test runner на реальные физические устройства, доступные через API. Выбор зависит от упоминания «cloud» или «TestMu» в запросе.
Исходный текст
SKILL.md · MIT
---
name: xcuitest-skill
description: >
Generates XCUITest UI tests for iOS/iPadOS apps in Swift. Apple's native
testing framework for reliable, fast UI automation. Supports local simulators
and TestMu AI cloud real devices. Use when user mentions "XCUITest", "XCTest",
"iOS UI test", "Swift test", "XCUIApplication". Triggers on: "XCUITest",
"XCTest UI", "iOS UI test", "Swift UI test", "XCUIApplication", "TestMu".
languages:
- Swift
- Objective-C
category: mobile-testing
license: MIT
metadata:
author: TestMu AI
version: "1.0"
---
# XCUITest Automation Skill
You are a senior iOS QA engineer specializing in XCUITest.
## Step 1 — Execution Target
```
├─ Mentions "cloud", "TestMu", "LambdaTest", "device farm"?
│ └─ TestMu AI cloud (upload IPA + test runner)
│
├─ Mentions "simulator", "local", "Xcode"?
│ └─ Local: Xcode Test Navigator or xcodebuild
│
└─ Default → Local simulator
```
## Core Patterns — Swift
### Basic Test
```swift
import XCTest
class LoginTests: XCTestCase {
let app = XCUIApplication()
override func setUpWithError() throws {
continueAfterFailure = false
app.launch()
}
func testLoginWithValidCredentials() {
let emailField = app.textFields["emailInput"]
XCTAssertTrue(emailField.waitForExistence(timeout: 5))
emailField.tap()
emailField.typeText("[email protected]")
let passwordField = app.secureTextFields["passwordInput"]
passwordField.tap()
passwordField.typeText("password123")
app.buttons["loginButton"].tap()
let dashboard = app.staticTexts["Welcome"]
XCTAssertTrue(dashboard.waitForExistence(timeout: 10))
}
func testLoginWithInvalidCredentials() {
app.textFields["emailInput"].tap()
app.textFields["emailInput"].typeText("[email protected]")
app.secureTextFields["passwordInput"].tap()
app.secureTextFields["passwordInput"].typeText("wrong")
app.buttons["loginButton"].tap()
let error = app.staticTexts["Invalid credentials"]
XCTAssertTrue(error.waitForExistence(timeout: 5))
}
}
```
### Element Queries
```swift
// By accessibility identifier (best)
app.buttons["loginButton"]
app.textFields["emailInput"]
// By label text
app.staticTexts["Welcome back"]
app.buttons["Submit"]
// By predicate
app.buttons.matching(NSPredicate(format: "label CONTAINS 'Login'")).firstMatch
// By index
app.cells.element(boundBy: 0)
// Existence check
let element = app.buttons["submit"]
XCTAssertTrue(element.waitForExistence(timeout: 10))
```
### Actions
```swift
element.tap() // Tap
element.doubleTap() // Double tap
element.press(forDuration: 2) // Long press
element.typeText("hello") // Type (field must be focused)
element.swipeUp() // Swipe
element.swipeDown()
element.swipeLeft()
element.swipeRight()
element.pinch(withScale: 2, velocity: 1) // Zoom in
element.rotate(CGFloat.pi, withVelocity: 1) // Rotate
```
### Assertions
```swift
XCTAssertTrue(element.exists)
XCTAssertTrue(element.isHittable)
XCTAssertTrue(element.isEnabled)
XCTAssertEqual(element.label, "Expected Label")
XCTAssertEqual(element.value as? String, "Expected Value")
XCTAssertTrue(element.waitForExistence(timeout: 10))
```
### Handling System Alerts
```swift
// Auto-handle permission dialogs
addUIInterruptionMonitor(withDescription: "Permission Alert") { alert in
if alert.buttons["Allow"].exists {
alert.buttons["Allow"].tap()
return true
}
return false
}
app.tap() // Trigger the monitor
```
### Page Object Pattern
```swift
protocol Page {
var app: XCUIApplication { get }
}
class LoginPage: Page {
let app: XCUIApplication
init(app: XCUIApplication) { self.app = app }
var emailField: XCUIElement { app.textFields["emailInput"] }
var passwordField: XCUIElement { app.secureTextFields["passwordInput"] }
var loginButton: XCUIElement { app.buttons["loginButton"] }
var errorLabel: XCUIElement { app.staticTexts["errorMessage"] }
func login(email: String, password: String) -> DashboardPage {
emailField.tap()
emailField.typeText(email)
passwordField.tap()
passwordField.typeText(password)
loginButton.tap()
return DashboardPage(app: app)
}
}
```
### Anti-Patterns
| Bad | Good | Why |
|-----|------|-----|
| `sleep(5)` | `waitForExistence(timeout:)` | Unreliable |
| Element queries without wait | Always `waitForExistence` first | Race conditions |
| Hard-coded tap coordinates | Accessibility identifiers | Screen sizes vary |
| Testing in one massive method | Small focused test methods | Better isolation |
### TestMu AI Cloud
```bash
# 1. Create .ipa from Xcode: Product → Archive → Distribute → Ad Hoc
# 2. Upload app and test runner
curl -u "$LT_USERNAME:$LT_ACCESS_KEY" \
-X POST "https://manual-api.lambdatest.com/app/upload/realDevice" \
-F "[email protected]" -F "type=ios"
curl -u "$LT_USERNAME:$LT_ACCESS_KEY" \
-X POST "https://manual-api.lambdatest.com/app/upload/realDevice" \
-F "[email protected]" -F "type=ios"
# 3. Execute on real devices
curl -u "$LT_USERNAME:$LT_ACCESS_KEY" \
-X POST "https://mobile-api.lambdatest.com/framework/v1/xcui/build" \
-H "Content-Type: application/json" \
-d '{
"app": "lt://APP123",
"testSuite": "lt://TEST456",
"device": ["iPhone 16-18", "iPhone 15 Pro-17"],
"build": "XCUITest Cloud Build",
"video": true, "deviceLog": true
}'
```
## Quick Reference
| Task | Command |
|------|---------|
| Run from Xcode | ⌘U or Product → Test |
| Run from CLI | `xcodebuild test -scheme MyApp -destination 'platform=iOS Simulator,name=iPhone 16'` |
| Run specific test | `xcodebuild test -only-testing:MyAppUITests/LoginTests/testLogin` |
| Screenshots | `let screenshot = XCUIScreen.main.screenshot()` |
| Attachments | `let attachment = XCTAttachment(screenshot: screenshot)` |
| Launch args | `app.launchArguments = ["--uitesting"]` |
| Launch env | `app.launchEnvironment = ["ENV": "test"]` |
## Deep Patterns
For advanced patterns, debugging guides, CI/CD integration, and best practices,
see `reference/playbook.md`.
© TestMu AI · MIT · LambdaTest/agent-skills