iOS Simulator Skill

Скилл со скриптами для сборки iOS-приложений и управления симулятором через дерево доступности, с экономным выводом для агента

СкиллСредний риск

conorluddy/ios-simulator-skill

Установка

/plugin marketplace add conorluddy/ios-simulator-skill
/plugin install ios-simulator-skill@conorluddy

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Скилл дает агенту набор Python- и shell-скриптов поверх xcodebuild, xcrun simctl и idb. Сборка и тесты идут с разбором xcresult и постепенным раскрытием ошибок, чтобы не забивать контекст логами. Навигация по интерфейсу строится на дереве доступности: агент получает короткий список элементов, находит кнопку или поле по тексту, типу или идентификатору и нажимает или вводит текст без анализа скриншотов. Есть скрипты для жестов, клавиатуры, логов, проверки доступности, визуального сравнения и управления жизненным циклом симуляторов.

Для кого. Для iOS-разработчиков на macOS, которые поручают агенту сборку, запуск и проверку приложений в симуляторе.

Подходит, если

  • Нужно, чтобы агент сам собрал приложение и проверил экран в симуляторе
  • Логи xcodebuild съедают контекст агента
  • Нужно пройти сценарий в интерфейсе и проверить доступность

Не подходит, если

  • Нужны только инструменты сборки без симулятора: у автора есть отдельный xclaude-plugin
  • Вы работаете не на macOS или с Android

Пример запроса к агенту

Собери приложение, запусти в симуляторе, войди с тестовым email и проверь, что открылся главный экран

Ограничения

Нужны macOS 15 и новее, Xcode 26 и новее, Python 3.12 и idb версии 1.5.1 и выше из tap facebook/fb. На Xcode 27 со старым idb-companion нажатия молча не срабатывают. Pillow нужен только для визуальных сравнений.

Как отключить. Удалите плагин через /plugin или папку ~/.claude/skills/ios-simulator-skill.

Проверка безопасности

  • Запускает скрипты, сборку и управляет симуляторами на машине

Коротко о README

README описывает две стороны скилла: сборку через xcodebuild и работу с симулятором через simctl и idb. Установка через маркетплейс плагинов Claude Code, из архива релиза или копированием папки скилла из клона. Подробно разобраны требования, установка и обновление idb, особенности Xcode 27, где Simulator.app заменен DeviceHub. Лицензия MIT.

SKILL.md

---
name: ios-simulator-skill
version: 1.5.0
description: 29 production-ready scripts for iOS app testing, building, and automation. Provides semantic UI navigation, build automation, accessibility testing, and simulator lifecycle management. Optimized for AI agents with minimal token output.
---

# iOS Simulator Skill

Build, test, and automate iOS applications using accessibility-driven navigation and structured data instead of pixel coordinates.

## Quick Start

```bash
# 1. Check environment
bash scripts/sim_health_check.sh

# 2. Launch app
python scripts/app_launcher.py --launch com.example.app

# 3. Map screen to see elements
python scripts/screen_mapper.py

# 4. Tap button
python scripts/navigator.py --find-text "Login" --tap

# 5. Enter text
python scripts/navigator.py --find-type TextField --enter-text "user@example.com"
```

All scripts support `--help` for detailed options and `--json` for machine-readable output.

## Navigation Strategy

**Always prefer the accessibility tree over screenshots for navigation.** The accessibility tree gives you element types, labels, frames, and tap targets — structured data that's cheaper and more reliable than image analysis.

Частые вопросы

Почему не скриншоты?

Дерево доступности дает структурированные данные и стоит на порядки меньше токенов, скриншоты остаются для визуальной проверки.

Есть ли MCP-вариант?

Да, автор ведет отдельный сервер XC-MCP.

Выбор редакции

MCP-сервер и CLI от Sentry для сборки, запуска и тестирования iOS и macOS проектов Xcode из AI-агента

MCP-серверСредний риск6,4 тыс.
Выбор редакции

Скилл Пола Хадсона для ревью и написания SwiftUI под iOS 26: устаревшие API, поток данных, навигация, доступность, производительность

СкиллНизкий риск4,7 тыс.
Выбор редакции

Официальные скиллы Expo для агентов: сборка, деплой, обновление и отладка приложений на Expo и EAS

ПлагинСредний риск2,5 тыс.

Открытая модель и фреймворк агента для смартфона: видит экран и сам нажимает в приложениях Android, HarmonyOS и iOS по текстовой команде

CLIВысокий риск26,2 тыс.