Agent skill

Simulator

by woocommerce in woocommerce/woocommerce-ios

Discover and boot an iOS simulator. An agent skill from woocommerce/woocommerce-ios.

GPL-2.0Auto-check: notesMobile

Install Simulator

skills CLI
$ npx skills add woocommerce/woocommerce-ios --skill simulator -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install woocommerce/woocommerce-ios simulator --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/woocommerce/woocommerce-ios.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/simulator .claude/skills/simulator && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
simulator
GitHub stars
358
Token cost
~295 tokens
SKILL.md length
122 words
Files
1
Skills in repo
12
Repo updated
First seen
Licence
GPL-2.0

At a glance

Discover and boot an iOS simulator. An agent skill from woocommerce/woocommerce-ios.

  • Mobile work in your project
  • SKILL.md covers Usage, Output and Watch
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Simulator is an agent skill from woocommerce/woocommerce-ios. Discover and boot an iOS simulator. Use before any command that needs a simulator UDID.

Its SKILL.md is about 300 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Mobile. It works with iOS and WooCommerce. The licence is GPL-2.0.

When your agent uses it

  • Mobile work in your project

Example prompts

  • “/simulator”

Requirements

  • Pre-approved tools (allowed-tools): Bash

What it can do on your machine

Read from SKILL.md and the folder at commit b061662. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Simulator loads about 295 tokens when it runs. Until then it costs about 24 tokens; SKILL.md has 122 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~24
When it runs · the whole SKILL.md, loaded when a task matches
~295

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from woocommerce/woocommerce-ios at commit b061662, republished under its GPL-2.0 licence (© woocommerce). 122 words, ~295 tokens.

Download SKILL.mdSave it as .claude/skills/simulator/SKILL.md (or your agent's skills folder).
name
simulator
description
Discover and boot an iOS simulator. Use before any command that needs a simulator UDID.
allowed-tools
Bash
user-invocable
true
argument-hint
[iphone|ipad]

Discover and Boot iOS Simulator

Find a booted simulator or boot one. Returns the UDID for use in subsequent commands. Defaults to iPhone; pass ipad to use an iPad instead.

Never hardcode a simulator name (e.g., iPhone 16). Available simulators change across Xcode versions — always discover dynamically.

Usage

Run the script:

bash
# iPhone (default):
UDID=$(Scripts/find-simulator.sh iphone)

# iPad:
UDID=$(Scripts/find-simulator.sh ipad)

The script prints the UDID to stdout and status messages to stderr. It will boot a simulator if none is already running.

Output

Report the simulator name and UDID so the caller can use it:

Simulator ready: iPhone 17 (93E9F784-2B91-4D83-BFA5-F1682C28180B)

Watch

Watch app verification is not supported — the Watch app runs on a separate watchOS simulator with a different build destination (watchOS Simulator). It cannot be tested via the iPhone/iPad iOS simulator used for app verification.

© woocommerce, GPL-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/simulator of woocommerce/woocommerce-ios.

Open the folder on GitHubat commit b061662

Compare with similar skills

Simulator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Simulator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Simulator this skillwoocommerce/woocommerce-ios358—~295Automated safety check: NotesGPL-2.0
Orca iOS Simulator Controlstablyai/orca87k1 repos~584Automated safety check: PassApache-2.0
UI Kitten Showcase QAakveo/react-native-ui-kitten11k—~2.3kAutomated safety check: PassMIT
Swiftui Expert SkillAvdLee/SwiftUI-Agent-Skill3.7k—~2.9kAutomated safety check: PassMIT
Swiftui Expert SkillEslzzyl/Pixiv-SwiftUI1115 repos~3.1kAutomated safety check: PassAGPL-3.0
Apple Crash Log .NET Symbolicationdotnet/skills5.6k1 repos~2.4kAutomated safety check: PassMIT

Similar skills

  • iOS Simulator control from inside Orca, with the live device view in Orca's emulator pane. Use when driving a booted Apple Simulator on macOS: taps, gestures…

    87k GitHub starsUsed in 1 repo~584 tokens
    MobileAuto-check passed
  • UI Kitten Showcase QA

    akveo/react-native-ui-kitten

    Drives the Expo showcase app in an iOS simulator with agent-device to sweep every UI Kitten component in all theme and mapping combinations, reporting regressions with evidence.

    11k GitHub stars~2.3k tokensUpdated yesterday
    MobileAuto-check passed
  • Swiftui Expert Skill

    AvdLee/SwiftUI-Agent-Skill

    A skill your agent uses when writing, reviewing, or refactoring SwiftUI code for iOS or macOS, including state and @Observable data flow, view composition, resizable layouts, safe areas, display…

    3.7k GitHub stars~2.9k tokensUpdated yesterday
    MobileAuto-check passed
  • Swiftui Expert Skill

    Eslzzyl/Pixiv-SwiftUI

    A skill your agent uses when writing, reviewing, or refactoring SwiftUI code for iOS or macOS, including state management and @Observable data flow, view composition and invalidation/performance…

    111 GitHub starsUsed in 5 repos~3.1k tokens
    MobileAuto-check passed
  • Official

    Resolves .NET runtime frames in Apple .ips crash logs to function names, source files and line numbers using dSYM symbols, atos and the Microsoft symbol server.

    5.6k GitHub starsUsed in 1 repo~2.4k tokens
    MobileAuto-check passed
  • Mobilerun Docs Reference

    droidrun/mobilerun

    Answers questions about Mobilerun, the LLM-agent framework for automating Android and iOS devices, by pointing the agent to the right page of its v5 documentation.

    9.6k GitHub stars~943 tokensUpdated 2 days ago
    MobileAuto-check passed

More from woocommerce/woocommerce-ios

All 12 skills in this repo
  • Auto Login

    woocommerce/woocommerce-ios

    Launch the WooCommerce app on a simulator already authenticated into a given store (site credentials, application password, or WPCom), skipping the manual login UI.

    358 GitHub stars~1.3k tokensUpdated today
    Auto-check: notes
  • Setup Context A8c

    woocommerce/woocommerce-ios

    Set up the ContextA8C MCP server for accessing Automattic internal resources (Slack, Linear, P2s, GitHub Enterprise, etc.)

    358 GitHub stars~627 tokensUpdated today
    Auto-check: notes
  • Snapshot

    woocommerce/woocommerce-ios

    Use swift-snapshot-testing to visually verify SwiftUI views during implementation.

    358 GitHub stars~1.8k tokensUpdated today
    Auto-check: notes
  • Woo AI Smoke

    woocommerce/woocommerce-ios

    Evaluate WooAIAssistant against a structured scenario suite with hard invariants + LLM-as-judge rubric scoring.

    358 GitHub starsUsed in 1 repo~7.4k tokens
    Auto-check: notes
  • Verify

    woocommerce/woocommerce-ios

    Build the app, launch on simulator, and verify feature behavior via mobile-mcp interaction.

    358 GitHub stars~1.2k tokensUpdated today
    Auto-check: notes
  • Debug

    woocommerce/woocommerce-ios

    Debug a failing test or build error in WooCommerce iOS. An agent skill from woocommerce/woocommerce-ios.

    358 GitHub stars~539 tokensUpdated today
    Auto-check: notes

Works with

Categories

Questions about Simulator

What does Simulator do?

Discover and boot an iOS simulator. An agent skill from woocommerce/woocommerce-ios. Simulator is an agent skill from woocommerce/woocommerce-ios. Discover and boot an iOS simulator.

When should I use Simulator?

Simulator fits situations like: mobile work in your project.

How do I install Simulator in Claude Code?

Run `npx skills add woocommerce/woocommerce-ios --skill simulator -a claude-code`. Or copy the skill folder (.claude/skills/simulator in woocommerce/woocommerce-ios) into .claude/skills/simulator in your project. Claude Code loads it when a task matches its description.

How do I install Simulator in Codex?

Run `npx skills add woocommerce/woocommerce-ios --skill simulator -a codex`. Or copy the skill folder (.claude/skills/simulator in woocommerce/woocommerce-ios) into .agents/skills/simulator in your project. Codex loads it when a task matches its description.

Can I use Simulator in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add woocommerce/woocommerce-ios --skill simulator -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/simulator, .gemini/skills/simulator, .github/skills/simulator and .opencode/skills/simulator in your project.

What does Simulator need to run?

SKILL.md names no scripts, command-line tools or credentials: Simulator is instructions for the agent only. Its frontmatter pre-approves these tools: Bash.

Does Simulator access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Simulator safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Simulator use?

Simulator is published under the GPL-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Simulator use?

About 295 tokens (SKILL.md is roughly 1.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Simulator?

Skills that share tags, products or a category with Simulator: Orca iOS Simulator Control (stablyai/orca, 87k stars), UI Kitten Showcase QA (akveo/react-native-ui-kitten, 11k stars), Swiftui Expert Skill (AvdLee/SwiftUI-Agent-Skill, 3.7k stars) and Swiftui Expert Skill (Eslzzyl/Pixiv-SwiftUI, 111 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Simulator?

woocommerce (a GitHub organization) maintains it in woocommerce/woocommerce-ios, which has 358 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 7, 2026.

Source: woocommerce/woocommerce-ios on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.