mobile-use-setup_skill

Overview

This skill is an interactive setup wizard for the Minitap mobile-use SDK that guides you through configuring mobile automation for iOS and Android. It walks you from requirement gathering through dependency checks, installation, credential configuration, device-specific steps, and generating a starter script. It supports both Platform (managed) and Local (self-managed) LLM modes and works with physical devices, simulators, and cloud virtual devices.

How this skill works

The wizard asks a short series of targeted questions to determine platform, LLM mode, and device type, then runs a checklist of prerequisite commands and dependencies tailored to those choices. It provides concrete install commands for missing tools (Appium, adb, libimobiledevice, idb-companion, uv), produces project scaffolding and .env guidance, and emits a ready-to-run main.py example based on Platform or Local mode. It also includes verification commands and device-specific instructions such as Xcode signing or enabling USB debugging.

When to use it

• You want to set up mobile automation for an iOS or Android app
• You need to configure the Minitap mobile-use SDK for Platform or Local LLM modes
• You are connecting physical iOS/Android devices or using cloud virtual devices
• You are creating a new mobile testing project scaffolded with uv
• You need guided, step‑by‑step device-specific setup (Xcode, ADB, simulators)

Best practices

• Choose Platform mode for simpler LLM management and use MINITAP_API_KEY in .env
• Use Local mode when you need custom LLM settings; copy and edit llm-config.override.jsonc
• Add .env to .gitignore to avoid leaking API keys
• Run prerequisite checks (python3, uv, adb, idevice_id, idb_companion) before installing packages
• Follow device-specific manual steps: Xcode WebDriverAgent signing for iOS, enable USB debugging for Android

Example use cases

• New iOS automation project using a physical iPhone and Platform LLM mode
• Android testing with cloud virtual devices managed by Minitap Platform
• Full local development: both iOS and Android with custom LLM profiles and provider API keys
• Quick verification: validate device connections and SDK import with provided commands
• Generate a starter main.py for Platform or Local mode and run a basic task to confirm setup