The candidate passed the bounded runtime evidence shown below. Download remains disabled until license approval and the final release manifest.
The outcome
Turn ordinary requests to run or test an iPhone/iPad app on a Mac into a safe, reproducible Simulator workflow while preserving project toolchain identity, device state, artifact identity, test oracles, and real-device limitations.
Use it when
- Invoke automatically when the user asks to start, install, run, operate, test, screenshot, record, or diagnose an app in iOS Simulator on macOS.
- Use for bounded outcomes such as verifying one journey, reproducing a crash, checking permission denial, capturing dark-mode screens, or preparing an isolated Simulator; do not use it as physical-device or App Store certification.
It does not do
- Does not replace the user’s final authorization for project scope, account access, external changes, or business consequences.
- Does not represent repository static checks as runtime certification across every platform, provider account, or production environment.
Inputs
- Requested outcome and stop state, target project or Simulator `.app`, expected behavior, authorized state changes, desired device/runtime matrix, test data references, and evidence location.
- Project-bound toolchain information, bundle/version/build identity, backend environment, required scenarios and oracles, cleanup policy, and any capability that needs real-device follow-up.
Outputs
- The requested setup, installed build, verified scenario set, reproduced defect, visual capture, or cleanup state with exact Simulator, toolchain, artifact, and revision identity.
- Inspected screenshots or recordings, scoped diagnostics, failure attribution, cleanup result, explicit limitations, real-device follow-up, and a validated secret-safe run manifest for nontrivial work.
Natural-language triggers
Run this Flutter app in an appropriate iPhone Simulator and verify the complete onboarding flow.
Reproduce the login crash on iOS Simulator, collect scoped evidence, and stop without changing the code.
Capture inspected light and dark mode screenshots at normal and accessibility text sizes.
Use $ios-simulator-app-tester explicitly only when automatic routing needs disambiguation.
Permission map
Environment & requirements
Agents
- Codex
- Claude Code
Platforms
- macOS
Required tools
- Xcode
- iOS Simulator
- target app toolchain
Data handling
May read local projects, simulator logs, and test screenshots; evidence must be sanitized and must not contain real user data or credentials.
Credential handling
Uses only existing secure credential channels authorized by the user; tokens, keys, cookies, private keys, and real user data must not be copied into the Skill, logs, reports, or public artifacts.
Verification evidence
Version 1.0.0 completed a project-bound FVM build, exact-UDID install, installed-identity read-back, launch, human screenshot inspection, scoped diagnostics, and state restoration on a real iOS Simulator without deleting a device, app data, or collecting an app container.
- Level
- Verified
- Checked
- 2026-10-12
- Expires
- 2027-01-10
- Source revision
fac86e9d2646
Environment
- macOS 26.2
- Xcode 26.2 Build version 17C52
- Flutter 3.27.0 via project-bound .fvm/flutter_sdk
- iOS 26.3 on iPhone 17 Pro (exact UDID used during the private run and omitted from public evidence)
Targets checked
- Candidate ZIP validator self-test and completed-run manifest validation
- Project-bound FVM iOS Simulator Debug build
- Exact-UDID boot, install, installed identity read-back, launch, screenshot, terminate, and shutdown
- Human visual inspection of the rendered first screen
- Scoped Runner error and fault diagnostics without app-container capture
Evidence IDs
ios-simulator-validator-self-testios-simulator-fvm-build-install-manifestios-simulator-capture-manifestios-simulator-installed-identityios-simulator-inspected-launch-screenshotios-simulator-scoped-diagnostics
Limits & support
Known limitations
- Verification applies only to the exact artifact, source revision, environment, and test scope recorded; it does not certify every provider account, region, or future version.
- Agents, platforms, and provider interfaces continue to change; each run must inspect current state and respect explicit confirmation gates.
- Verification used one iPhone 17 Pro Simulator on iOS 26.3 and does not represent every device or OS version.
- The sample app emitted a RevenueCat default-offering warning in Simulator; this is not a skill execution failure and the app was not labeled fully verified.
- Real-device performance, production StoreKit transactions, APNs, hardware capabilities, and App Store distribution still require separate verification.
Permission changes
- No permission change is declared for this release; for a first public release, the permission map on this page is authoritative.
Channel
Submit through support@xiaoyuelabs.com or the on-site inquiry form.
Response target
Receipt is acknowledged within two business days; remediation timing is confirmed after reproduction and scope review.
Scope
Free support covers download integrity, documentation errors, and reproducible Skill defects; project adaptation, managed operation, and ongoing maintenance are separate services.
Release notes
- Added a natural-language iOS Simulator workflow covering inventory, build/install, interaction, environment variation, diagnosis, capture, cleanup, and full verification outcomes.
- Bound Flutter work to the project's FVM toolchain, selected Simulator devices by exact UDID, preserved existing data by default, and separated Simulator evidence from claims requiring real hardware.
- Added a bilingual, secret-safe test-run manifest and validator that reject global Flutter, broad or unauthorized destructive actions, incomplete evidence gates, and unsupported success claims.
Install & verify
Runtime verified, release approval pending
The private candidate passed the bounded runtime checks shown above. Public delivery remains closed until every release gate below is independently complete.
- Runtime verificationComplete for this exact candidate and source revision.
- Owner-approved licenseXiaoyue Skill License 1.0 was approved on October 13, 2026.
- Checksum-bound release manifestCreated separately for each explicitly published release.
- Private R2 upload and read-backNot uploaded and not publicly reachable.