Sim Drive Fallback

Drive the iOS Simulator when computer-use can't — for bypassing CU outages, not diagnosing them (use `/cu-diagnose` for diagnosis). Trigger when `mcp__computer-use__screenshot` returns `CU display unavailable`, when the user mentions "CU fallback", "CU substitute", or "drive sim without computer-use", or when continuing a verification that was previously blocked by a CU outage.

49 stars 21 forksMobile Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add lllyys/vreader --skill sim-drive-fallback
Manual install
git clone --depth 1 https://github.com/lllyys/vreader.git /tmp/vreader
mkdir -p ~/.claude/skills
cp -r /tmp/vreader/.claude/skills/sim-drive-fallback ~/.claude/skills/sim-drive-fallback

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Sim Drive Fallback

CU MCP capture occasionally returns `"CU display unavailable"` on this
host even when a real monitor is attached and `screencapture -x`
succeeds at the OS level. This skill is the working substitute — the
subset of touch gestures that the iOS Simulator translates from mac
mouse/keyboard events posted via CGEventPost. Enough for most
single-tap / SwiftUI-sheet-drag / TextField-paste verifications.

## When to use

- A verify-cron iteration calls `mcp__computer-use__screenshot` and
  gets `CU display unavailable` (despite `request_access` returning a
  successful grant for Simulator).
- A user task mentions "CU substitute", "CU fallback", "drive the sim
  without computer-use", or "verify without CU".
- You need to verify a UI-gesture-driven bug fix or feature acceptance
  criterion and the primary CU path is out.
- You're picking up a verification that a prior cron iteration marked
  `blocked: CU display unavailable` — the workflow may now be possible
  through this toolkit even though CU itself is still down.

Do NOT use this for: rubber-band overscroll, long-press → context
menu, multi-touch / pinch, or anything requiring continuous WKWebView
touch-drag — those don't translate via CGEventPost. See "Capability
bounds" below.

## The toolchain

In typical order of use for one verification slice:

### 1. Capture — `xcrun simctl io booted screenshot <abs_path>`
Read the full skill on GitHub

Details

Skill name
sim-drive-fallback
Repository
lllyys/vreader
Path
.claude/skills/sim-drive-fallback/SKILL.md
Repo updated
6 August 2026

FAQ

What does the Sim Drive Fallback skill do?

Drive the iOS Simulator when computer-use can't — for bypassing CU outages, not diagnosing them (use `/cu-diagnose` for diagnosis). Trigger when `mcp__computer-use__screenshot` returns `CU display unavailable`, when the user mentions "CU fallback", "CU substitute", or "drive sim without computer-use", or when continuing a verification that was previously blocked by a CU outage.

How do I install the Sim Drive Fallback skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add lllyys/vreader --skill sim-drive-fallback. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Sim Drive Fallback popular?

It lives in lllyys/vreader, which has 49 GitHub stars and 21 forks.

Related skills

AI Coding Agents

49

lllyys/vreader

Comprehensive guide for using Codex CLI (OpenAI) and Claude Code CLI (Anthropic) - AI-powered coding agents. Use when orchestrating CLI commands, automating tasks, configuring agents, or troubleshooting issues.

AI, LLMs & Agents21

Dispatch

49

lllyys/vreader

Parallel lane dispatch — the ONLY sanctioned multi-item fan-out (feature #130, rule 55). Use when the user asks to fix several bugs at once ('fix #a #b #c'), implement independent feature WIs in parallel, or run a dispatch batch. Orchestrates worktree-isolated implementer lanes on leased simulators, validates HANDOFFs, and runs the serial integration tail (rebase → re-test → tracker/docs → version-at-slot → PR → merge-from-worktree → tag). A single item degrades to the inline /fix-issue or /feature-workflow flow.

Git & Code Review21

Feature Workflow

49

lllyys/vreader

Run the binding 6-gate feature workflow end-to-end per rule 47 (Plan → Independent Plan Audit → TDD Implementation → Implementation Audit Loop → Device/Integration Verification → Merge). Use this skill whenever the user wants to implement a new feature in vreader, asks 'implement feature #N', 'work on feature 47', 'start the feature workflow', 'plan + build feature X', or describes building a new capability that doesn't yet exist. NOT for fixing broken implementations (that's fix-issue). The skill drives the row from `TODO` → `VERIFIED` through six gates that must never be skipped — author/aud

Productivity & Notes21

Sim Transfer

49

lllyys/vreader

Transfer files from the host Mac to the iOS Simulator. Use this skill whenever the user asks to push, upload, copy, or transfer a file to the simulator, or when you need to get a book/document/file into a running iOS app on the simulator. Also triggers when the user says things like "put this file in the simulator", "import this into the app", or "send this to the iPhone". Handles macOS TCC restrictions (~/Downloads, ~/Desktop, ~/Documents) automatically via Finder AppleScript.

Mobile Development21

Build Swiftui Interface

51

memi-design/memi

Use when a coding agent must design, scaffold, implement, or verify an iOS or macOS SwiftUI interface with Apple-platform state, accessibility, availability, testing, and Xcode evidence.

Mobile DevelopmentIn 1 list

IOS Memo Bak

43

coracoo/zspace_skill

Use when 用户想把 iPhone 备忘录自动备份到 NAS 记事本 — "帮我设置 iPhone 备忘录同步"、"重新告诉我一下怎么配"、"换一个新的备份密钥"、"我同事也要用这个功能"。 触发词:iPhone 备忘录同步、ios 备忘录 bak、备忘录备份到 NAS、备忘 → NAS、iPhone notepad sync、ios 备忘录、备忘录同步、iphone shortcut 备份、iPhone 推笔记、给我配 iPhone 备份、帮我把备忘录同步到 NAS。 不适用:不是直接写 NAS 的 skill — 实际写由 iPhone Shortcut 发起;此 skill 只设置基础设施(生成密钥 + 重启 dashboard + 给配置步骤)。

Mobile Development13

Browse the most popular Claude skills, all mobile development skills, or write your own with the skills generator.