docs: strengthen RocketSim skill messaging

Clarify the public skill's trigger language around RocketSim-driven simulator interaction and rewrite the README to explain RocketSim first, then the agent skill's value, installation options, and verification flow.

Author: AvdLee

Agent-Skill/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: rocketsim
-description: "Interact with iOS Simulator apps using the RocketSim CLI. Read on-screen accessibility elements, send tap events, and automate simulator interaction. Use when: (1) interacting with a simulator app, (2) tapping a simulator element or button, (3) reading screen elements or accessibility elements, (4) RocketSim CLI or rocketsim command, (5) automating simulator UI, (6) testing an app in the simulator with AI, (7) simulating user taps or touches."
+description: "Use RocketSim to inspect and interact with iOS Simulator apps. Detects the installed RocketSim version, loads the matching RocketSim CLI guidance, and enables agents to list visible accessibility elements, navigate screens, tap, long-press, swipe, type text, press simulator hardware buttons, and automate simulator flows reliably. Use when: (1) the user mentions RocketSim, the rocketsim command, or RocketSim CLI, (2) interacting with an app in the iOS Simulator, (3) navigating or testing a simulator app with AI, (4) reading screen elements, accessibility elements, or visible UI state, (5) tapping, long-pressing, swiping, typing, or pressing simulator buttons, (6) using RocketSim instead of ad-hoc simulator automation."
 ---
 
 # RocketSim Agent Skill
 
-This skill locates a valid RocketSim app bundle and loads its bundled CLI reference. All command knowledge lives inside the app bundle so it stays in sync with the installed version.
+This skill lets agents use RocketSim as a reliable Simulator interaction layer. It finds a valid RocketSim app bundle, loads the matching bundled CLI reference, and hands off to the installed RocketSim version so simulator automation stays version-aware and in sync with the app on disk.
 
 ## Step 1: Locate and validate RocketSim.app
 

README.md

@@ -1,30 +1,100 @@
-# RocketSim Agent Skill
+# RocketSim - Build Apps Faster
 
-RocketSim enhances the iOS Simulator with powerful developer tooling for testing, debugging, captures, accessibility, app actions, and more.
+RocketSim enhances the iOS Simulator with tools for testing, debugging, captures, accessibility, app actions, and more. It helps iOS developers move faster by making common Simulator workflows easier to inspect, automate, and repeat.
 
-This repository also ships the public `Agent-Skill`, a lightweight discovery skill for AI coding agents. Its job is simple: locate a valid RocketSim installation on disk, resolve the bundled in-app skill, and hand off simulator interaction to the RocketSim CLI that ships with the installed app.
+Developers use RocketSim to:
+
+- Inspect and debug simulator behavior faster
+- Trigger app actions and test flows without leaving their coding environment
+- Capture screenshots and recordings with less manual work
+- Automate simulator interaction through the RocketSim CLI and bundled agent skill
+
+## RocketSim Agent Skill
+
+The RocketSim agent skill gives AI coding tools a reliable way to work with the iOS Simulator through RocketSim. It detects the installed RocketSim version, uses the matching RocketSim CLI, and enables agents to inspect what is visible on screen before interacting with the app.
+
+In practice, this gives your agents eyes. Instead of guessing with brittle simulator automation, they can use RocketSim to understand the current UI state and interact with it efficiently using the same stateful tooling that powers RocketSim itself.
+
+### What it does
+
+- Detects the correct RocketSim app bundle on disk
+- Uses the matching RocketSim CLI for the installed version
+- Lets agents list visible elements on screen before taking action
+- Enables agents to tap, type, swipe, and move through Simulator flows more reliably
+
+### Why install it
+
+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 and test iOS Simulator apps
+- Read visible accessibility elements before interacting
+- Tap, type, swipe, and trigger flows more reliably
+- Use the RocketSim version already installed on your machine
 
 ## How It Works
 
-The public skill in this repository stays intentionally small and stable:
+The public skill in this repository stays intentionally small:
+
+- `Agent-Skill/SKILL.md` discovers 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
 
-- `Agent-Skill/SKILL.md` discovers a valid 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 interacting with the simulator.
+This split keeps the public discovery layer stable while letting the installed RocketSim app define the exact simulator automation capabilities for that version.
 
-This split keeps the public discovery layer easy to maintain while letting the installed RocketSim app define the exact simulator automation capabilities for that version.
+## How To Install
 
-## Install The Public Skill
+### Option A: Using skills.sh
 
-Clone this repository and symlink the public skill into your agent skills directory:
+Install this skill with a single command:
+
+```bash
+npx skills add https://github.com/AvdLee/RocketSimApp --skill rocketsim
+```
+
+### Option B: Claude Code
+
+To install this skill for your personal use in Claude Code:
+
+1. Add the marketplace:
+
+```bash
+/plugin marketplace add AvdLee/RocketSimApp
+```
+
+1. Install the skill:
+
+```bash
+/plugin install rocketsim@rocketsim
+```
+
+### Option C: Cursor
+
+Install or symlink the `Agent-Skill/` folder into your Cursor skills directory following Cursor's skills documentation.
 
 ```bash
-git clone --depth 1 https://github.com/AvdLee/RocketSimApp.git ~/.rocketsim-skill
 mkdir -p .cursor/skills
-ln -s ~/.rocketsim-skill/Agent-Skill .cursor/skills/rocketsim
+ln -s /path/to/RocketSimApp/Agent-Skill .cursor/skills/rocketsim
 ```
 
-Once installed, agents can use the skill to discover RocketSim and delegate simulator interaction to the bundled CLI.
+### Option D: Codex / OpenAI-compatible tools
+
+Copy or symlink the `Agent-Skill/` folder into your Codex skills directory:
+
+```bash
+cp -R Agent-Skill/ "$CODEX_HOME/skills/rocketsim"
+```
+
+See the [Codex skills documentation](https://developers.openai.com/codex/skills/) for where to save skills.
+
+### How To Verify
+
+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.
 
 ## Learn More
 
@@ -39,4 +109,4 @@ If you want to learn more about RocketSim itself, use the canonical product reso
 - Open a GitHub issue for bugs or feature requests related to RocketSim or this public skill.
 - Use the documentation site for feature guides and setup help.
 
-RocketSim is developed by [Antoine van der Lee](https://www.avanderlee.com) and built by SwiftLee.
+RocketSim is developed by [Antoine van der Lee](https://www.avanderlee.com) and built by SwiftLee.