An IOS Simulator Skill for ClaudeCode. Use it to optimise Claude's ability to build, run and interact with your apps, without using up any of the available token/context budget.
[!WARNING]
You want to take the ios-simulator-skill directory from this repo and drop it into your skills directory - not this entire repo. I'll update this soon with an easier approach. Feel free to fork this and get Claude to adjust it to your specific needs.
MCPs load a lot of tokens into the context window when they're active, but also seem to work really well. Skills don't load in any context. I'll make a plugin next and try to find the balance...
Updated: The Plugin version lets you easily disable MCPs for different tool groups. Optimise your context window by only enabling the tools you're actively using, such as xcodebuild: https://github.com/conorluddy/xclaude-plugin
What It Does
Instead of pixel-based navigation that breaks when UI changes:
# Fragile - breaks if UI changes
idb ui tap 320 400
# Robust - finds by meaning
python scripts/navigator.py --find-text "Login" --tap
Uses semantic navigation on accessibility APIs to interact with elements by their meaning, not coordinates. Works across different screen sizes and survives UI redesigns.
Features
21 production scripts for building, testing, and automation
Semantic navigation - find elements by text, type, or ID
build_and_test.py - Build projects, run tests, parse results
log_monitor.py - Real-time log monitoring
Navigation & Interaction
screen_mapper.py - Analyze current screen
navigator.py - Find and interact with elements
gesture.py - Swipes, scrolls, pinches
keyboard.py - Text input and hardware buttons
app_launcher.py - App lifecycle control
Testing & Analysis
accessibility_audit.py - WCAG compliance checking
visual_diff.py - Screenshot comparison
test_recorder.py - Automated test documentation
app_state_capture.py - Debugging snapshots
sim_health_check.sh - Environment verification
Advanced Testing & Permissions
clipboard.py - Clipboard management
status_bar.py - Status bar control
push_notification.py - Push notifications
privacy_manager.py - Permission management
Device Lifecycle
simctl_boot.py - Boot simulator
simctl_shutdown.py - Shutdown simulator
simctl_create.py - Create simulator
simctl_delete.py - Delete simulator
simctl_erase.py - Factory reset
See SKILL.md for complete reference.
How It Works with Claude Code
Claude Code automatically detects when to use this skill based on your request. You don't need to manually invoke it.
Example conversation:
You: "Set up my iOS app for testing"
Claude: [Uses simctl_boot.py and app_launcher.py automatically]
You: "Tap the login button"
Claude: [Uses navigator.py to find and tap]
You: "Check if the form is accessible"
Claude: [Uses accessibility_audit.py]
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
