xcode-device-hub-workflow
/xcode-device-hub-workflow
Manage and validate simulated and physical Apple devices through Xcode Device Hub. Use when selecting or inspecting run destinations, interacting with an app, changing simulated-device environment settings, capturing screenshots or videos, pairing a device, or collecting diagnostics.
- Author
- gaelic-ghost ↗
- Repository
- socket ↗
- Licence
- Apache-2.0
- Last repository change
- 26.08.2026
Assessment and security
- Files in this package
- 4
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 26.08.2026, without references to retired models or APIs.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
What it does and when to use it
Manage and validate simulated and physical Apple devices through Xcode Device Hub. Use when selecting or inspecting run destinations, interacting with an app, changing simulated-device environment settings, capturing screenshots or videos, pairing a device, or collecting diagnostics.
Original author description
Manage and validate simulated and physical Apple devices through Xcode Device Hub. Use when selecting or inspecting run destinations, interacting with an app, changing simulated-device environment settings, capturing screenshots or videos, pairing a device, or collecting diagnostics.
How it works
- Purpose
- When To Use
- Workflow
- Outputs
- Guards
- References
SKILL.md preview
--- name: xcode-device-hub-workflow description: Manage and validate simulated and physical Apple devices through Xcode Device Hub. Use when selecting or inspecting run destinations, interacting with an app, changing simulated-device environment settings, capturing screenshots or videos, pairing a device, or collecting diagnostics. --- # Xcode Device Hub Workflow ## Purpose Use Device Hub as Xcode's native surface for simulated and physical device work. It owns device selection, interaction, environment inspection, pairing, captures, and diagnostics; it does not replace project build/run, test, debugger, provisioning, or browser-mirror ownership. Use `xcrun devicectl` as its scriptable companion only for a bounded device-management or diagnostic need, never as a substitute for an XCUITest result. ## When To Use - Use this workflow for a Device Hub request, a run-destination decision, simulator or physical-device inspection, screenshots, videos, environment variants, pairing, or downloaded diagnostics. - Use it when a running Xcode app should be observed or interacted with through Device Hub rather than by opening a separate Simulator window. - Hand project build, install, launch, and scheme selection to `xcode-build-run-workflow`. - Hand test design and execution to `xcode-testing-workflow`; hand breakpoints and stack inspection to `xcode-debugger-mcp-workflow`. - Hand a future local browser mirror or Swift Package preview host to the future AgentDeck runtime; do not substitute a browser bridge for Device Hub until that runtime exists and reports ready. ## Workflow 1. Read the target app, device type, runtime, and evidence goal. Distinguish a normal simulated-device check from a hardware-only, performance, camera, sensor, or pairing requirement. 2. Open the intended Xcode app and Device Hub. Open it from the run-destination menu's Manage Devices action or Xcode's Open Developer Tool menu when no app run has already opened the compact view. 3. Select the device and record its name, platform, operating-system version, and device identifier from the inspector. Keep the selected run destination and the recorded identifier aligned; do not guess a matching simulator from its name alone. 4. For a simulated device, start it and change only the requested environment setting. Treat appearance, Liquid Glass, text size, and resize-mode checks as named variants with visible before/after evidence. 5. For a physical device, inspect pairing and Developer Mode state before attempting a run. Pairing, trust prompts, Developer Mode, unpairing, and configuration changes require explicit user intent at the point of mutation. 6. Run or interact with the app through its owning build/run workflow. Device Hub interaction is proof of the same target device state, not a separate app runtime. 7. Capture a screenshot or video only after the requested state is visible. Record the device identity, app state, and destination path; Device Hub screenshots are full device resolution and may contain sensitive content. 8. Download diagnostics only when they are relevant to the reported failure, then hand the artifact to the debugger, runtime-forensics, or test workflow. State the artifact's source and avoid copying private device data into logs or commits. For a repeatable script or CI need, inspect the selected toolchain's `xcrun devicectl --help` contract first and preserve the same device identifier in the resulting evidence. 9. Stop the app or device session through its owner. Do not erase, remove, unpair, or reset a device as routine cleanup. ## Outputs - device identity and simulated-versus-physical classification - environment or pairing state actually inspected - capture or diagnostic artifact and what it proves - explicit handoff for build/run, testing, debugger, provisioning, or runtime forensics ## Guards - Do not treat Simulator results as proof of hardware rendering, battery, thermal, sensor, camera, radio, or performance behavior. - Do not use Device Hub to infer a CoreSimulator UDID from a display name; inspect the identifier or hand discovery to the normal simulator tooling. - Do not pair, unpair, enable Developer Mode, remove a simulator, erase data, or change a physical-device setting without the user's explicit action request. - Do not expose a Device Hub screen or capture over a LAN, tunnel, or external browser surface. That is a separate AgentDeck runtime decision. - Do not call a loaded Device Hub window proof that an app build, launch, or test passed; verify the requested frame, log, test result, or diagnostic instead. - Do not treat `devicectl` installation, launch, screen interaction, or a Device Hub capture as proof that an XCUITest passed. Keep the test result and `.xcresult` as the automation authority. ## References - `references/device-hub-scope-and-evidence.md` - `references/device-hub-safety-and-handoffs.md`
Files in this package (4)
- SKILL.md 5 KB
- agents/openai.yaml 1 KB
- references/device-hub-safety-and-handoffs.md 1 KB
- references/device-hub-scope-and-evidence.md 1 KB
Versions
The database has no other skills named xcode-device-hub-workflow.
Database snapshot: 13.11.2026 · package version add4866e00b7 (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100apple-device-integration
Use for device or simulator UI verification through Apple's Xcode MCP after UI changes or an explicit device check. Inspect screenshots and UI hierarchies, exercise controls, and report functional or visual defects. - 100run-device
Build, install, and launch an iOS app on a physical iPhone or iPad entirely from the command line (no Xcode GUI), using xcodebuild + devicectl. Use when the user wants to run, test, or screenshot their app on a real device without opening Xcode. - 100xcode-management
Xcode 项目管理和 iOS/macOS 开发工作流程方面的专家。专注于管理 Xcode 项目文件、理解 .pbxproj 格式,以及自动化文件添加到 Xcode 项目的过程。使用此技能管理 Xcode 项目、添加新文件到项目、配置构建设置或处理项目文件问题时使用。 - 100ios-device-toolkit
Use when interacting with USB-attached iOS devices via pymobiledevice3 — screenshots, syslog, crash reports, app install/launch/pull, file transfer, sysmon perf, TCP port forwarding, WebInspector/CDP, and device diagnostics. - 100duo-setup
Sets up a Mac to build, run and test apps for iPhone Duo, the foldable iPhone with an outer display and an inner display, covering Xcode 27.1 next to an older Xcode with DEVELOPER_DIR (no sudo xcode-select), xcodebuild -version, the iOS 27.1 SDK and runtime, the iPhone Duo… - 98debug-device-over-vusb
Debug the user's app on a real Kobiton device attached to this machine over virtualUSB, driven by natural language. Installs the pinned virtualUSB client on first use (macOS: cached bundle; Windows: verified installer handed to the user), finds vUSB-ready private devices with…