The RocketSim Agent Skill is a companion skill for RocketSim that gives AI coding tools a reliable, stateful way to inspect and interact with iOS Simulator apps.
For the latest documentation on agentic coding with RocketSim, we encourage you to read the RocketSim documentation.
This repository contains only the installable skill assets, so tools like skills.sh, Claude Code, Cursor, and OpenAI-compatible agents can install the skill quickly without cloning the full RocketSim app repository.
The canonical install source for this skill is https://github.com/AvdLee/RocketSim-Agent-Skill, and the installable skill directory is Agent-Skill/.
- Detects the installed RocketSim version before interacting with the Simulator
- Uses the matching RocketSim CLI and bundled in-app skill for version-aware automation
- Lets agents list visible accessibility elements before taking action
- Enables agents to navigate screens, tap, long-press, swipe, type, and press simulator hardware buttons more reliably
Install this skill if you want your AI coding tool to use RocketSim as its Simulator interaction layer instead of relying on ad-hoc automation.
This is especially useful if you want an agent to:
- Navigate repetitive Simulator flows faster with fewer retries
- Read visible UI state before interacting with the app
- Spend fewer tokens by using RocketSim's compact
--agentelement output - Work against the RocketSim version already installed on your machine
The RocketSim Agent Skill stays intentionally small:
Agent-Skill/SKILL.mddiscovers and validates a RocketSim app bundle- It resolves the bundled in-app skill and CLI from the installed app
- The bundled skill contains the version-matched CLI guidance for simulator interaction
This split keeps the public discovery layer stable while letting the installed RocketSim app define the exact Simulator automation capabilities for that version.
Follow these steps:
- Install RocketSim from the Mac App Store.
- Install this skill using one of the options below.
- Open your agent and write a prompt similar to the example prompt shown below.
Example prompt:
Use RocketSim to navigate through <your_app_name> in the Simulator
Install this skill with a single command:
npx skills add https://github.com/AvdLee/RocketSim-Agent-Skill --skill rocketsimTo install this skill for your personal use in Claude Code:
- Add the marketplace:
/plugin marketplace add AvdLee/RocketSim-Agent-Skill- Install the skill:
/plugin install rocketsim@rocketsim-agent-skillThis repository includes Cursor plugin metadata. Install or symlink the Agent-Skill/ folder into your Cursor skills directory following Cursor's documentation:
mkdir -p .cursor/skills
ln -s /path/to/RocketSim-Agent-Skill/Agent-Skill .cursor/skills/rocketsimThis repository includes an agents/openai.yaml manifest. Copy or symlink the Agent-Skill/ folder into your Codex skills directory:
cp -R Agent-Skill/ "$CODEX_HOME/skills/rocketsim"See the Codex skills documentation for details on where to save skills.
All packaged install surfaces in this repository intentionally point at this same repository and the Agent-Skill/ directory, so keep those paths aligned if you fork or repackage the skill.
Open an agent and ask it to:
Use RocketSim to navigate through the
<app_name>in the Simulator
If the skill is installed and RocketSim is running, the agent should detect the installed RocketSim version, connect through the bundled CLI, inspect the visible Simulator UI, and start interacting with the app based on what is on screen.
- SwiftUI Expert
- Core Data Expert
- Swift Testing Expert
- Swift Concurrency Expert
- Xcode Build Optimization
If you want to learn more about RocketSim itself, use the canonical product resources:
- Open a GitHub issue in this repository for skill-specific bugs or installation issues.
- Use the RocketSim documentation site for product guides and feature help.
RocketSim is developed by Antoine van der Lee and built by SwiftLee.