Phoneagent
rounak/PhoneAgent
Control a connected iPhone, iOS simulator, Android emulator, or Android device from macOS through PhoneAgent's JSON-RPC bridge.
Automates interactions for Apple-platform apps (iOS, tvOS, macOS) and Android devices.
Install Agent Device
$ npx skills add callstackincubator/agent-skills --skill agent-device -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install callstackincubator/agent-skills agent-device --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/callstackincubator/agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/vendored/.agents/skills/agent-device .claude/skills/agent-device && rm -rf skills-srcUse ~/.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/
Install the "agent-device" agent skill from https://github.com/callstackincubator/agent-skills/tree/main/plugins/vendored/.agents/skills/agent-device into .claude/skills/agent-device/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-device", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/callstackincubator/agent-skills/tree/main/plugins/vendored/.agents/skills/agent-deviceType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add callstackincubator/agent-skills --skill agent-device -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install callstackincubator/agent-skills agent-device --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/callstackincubator/agent-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/vendored/.agents/skills/agent-device .agents/skills/agent-device && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "agent-device" agent skill from https://github.com/callstackincubator/agent-skills/tree/main/plugins/vendored/.agents/skills/agent-device into .agents/skills/agent-device/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-device", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add callstackincubator/agent-skills --skill agent-device -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install callstackincubator/agent-skills agent-device --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/callstackincubator/agent-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/vendored/.agents/skills/agent-device .cursor/skills/agent-device && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "agent-device" agent skill from https://github.com/callstackincubator/agent-skills/tree/main/plugins/vendored/.agents/skills/agent-device into .cursor/skills/agent-device/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-device", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/callstackincubator/agent-skills.git --path plugins/vendored/.agents/skills/agent-device--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add callstackincubator/agent-skills --skill agent-device -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install callstackincubator/agent-skills agent-device --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/callstackincubator/agent-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/vendored/.agents/skills/agent-device .gemini/skills/agent-device && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "agent-device" agent skill from https://github.com/callstackincubator/agent-skills/tree/main/plugins/vendored/.agents/skills/agent-device into .gemini/skills/agent-device/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-device", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install callstackincubator/agent-skills agent-deviceInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add callstackincubator/agent-skills --skill agent-device -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/callstackincubator/agent-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/vendored/.agents/skills/agent-device .github/skills/agent-device && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "agent-device" agent skill from https://github.com/callstackincubator/agent-skills/tree/main/plugins/vendored/.agents/skills/agent-device into .github/skills/agent-device/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-device", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add callstackincubator/agent-skills --skill agent-device -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install callstackincubator/agent-skills agent-device --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/callstackincubator/agent-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/vendored/.agents/skills/agent-device .opencode/skills/agent-device && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "agent-device" agent skill from https://github.com/callstackincubator/agent-skills/tree/main/plugins/vendored/.agents/skills/agent-device into .opencode/skills/agent-device/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agent-device", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
agent-device- GitHub stars
- 1.7k
- Token cost
- ~1.2k tokens
- SKILL.md length
- 613 words
- Files
- 8 (incl. references)
- Skills in repo
- 12
- Repo updated
- First seen
- Licence
- MIT
At a glance
Automates interactions for Apple-platform apps (iOS, tvOS, macOS) and Android devices.
- Works in 7 steps: Load references/bootstrap-install.md and… → Use bootstrap first to confirm or… → Once the app session is open and stable,… → …
- Navigating apps
- SKILL.md covers Default operating rules, Default flow, QA modes and Required references, plus 2 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Agent Device is an agent skill from callstackincubator/agent-skills, published by the product's own GitHub organization. Automates interactions for Apple-platform apps (iOS, tvOS, macOS) and Android devices. Use when navigating apps, taking snapshots/screenshots, tapping, typing, scrolling, or extracting UI info across mobile, TV, and desktop targets.
Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including reference files (for example `references/bootstrap-install.md`, `references/coordinate-system.md` and `references/debugging.md`).
It sits in Mobile, covering iOS development. It works with Android, iOS and macOS. The repository describes itself as: A collection of agent-optimized React Native skills for AI coding assistants. The licence is MIT.
When your agent uses it
- Navigating apps
- Taking snapshots/screenshots
- Extracting UI info across mobile
- Desktop targets
Example prompts
- “Use the agent-device skill to automate interactions for Apple-platform apps (iOS, tvOS, macOS) and Android devices”
- “/agent-device”
Workflow steps
7 steps, taken from the first numbered list in SKILL.md.
- Load references/bootstrap-install.md and references/exploration.md before acting on a normal device task.
- Use bootstrap first to confirm or establish the correct target, app install, and open app session.
- Once the app session is open and stable, use exploration for inspection, interaction, and verification.
- Start with plain snapshot if the goal is to read or verify what is visible.
- Escalate to snapshot -i only if you need refs for interactive exploration or a requested action.
- Use get, is, or find before mutating the UI when a read-only command can answer the question.
- End by capturing proof if needed, then close.
What it can do on your machine
Read from SKILL.md and the folder at commit 61e6e7d. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md.
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
Agent Device loads about 1.2k tokens when it runs, and up to ~10k if it reads all its reference files. Until then it costs about 61 tokens; SKILL.md has 613 words of instructions outside code blocks.
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 passed
The automated check found no risky patterns in SKILL.md.
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 callstackincubator/agent-skills at commit 61e6e7d, republished under its MIT licence (© callstackincubator). 613 words, ~1,222 tokens.
Download SKILL.mdSave it as
.claude/skills/agent-device/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.- name
- agent-device
- description
- Automates interactions for Apple-platform apps (iOS, tvOS, macOS) and Android devices. Use when navigating apps, taking snapshots/screenshots, tapping, typing, scrolling, or extracting UI info across mobile, TV, and desktop targets.
agent-device
Use this skill as a router with mandatory defaults. Read this file first. For normal device tasks, always load references/bootstrap-install.md and references/exploration.md before acting. Use bootstrap to confirm or establish deterministic setup. Use exploration for UI inspection, interaction, and verification once the app session is open.
Default operating rules
- Start conservative. Prefer read-only inspection before mutating the UI.
- Use plain
snapshotwhen the task is to verify what text or structure is currently visible on screen. - Use
snapshot -ionly when you need interactive refs such as@e3for a requested action or targeted query. - Avoid speculative mutations. You may take the smallest reversible UI action needed to unblock inspection or complete the requested task, such as dismissing a popup, closing an alert, or clearing an unintended surface.
- Do not browse the web or use external sources unless the user explicitly asks.
- Re-snapshot after meaningful UI changes instead of reusing stale refs.
- Prefer
@refor selector targeting over raw coordinates. - Ensure the correct target is pinned and an app session is open before interacting.
- Keep the loop short:
open-> inspect/act -> verify if needed ->close.
Default flow
- Load references/bootstrap-install.md and references/exploration.md before acting on a normal device task.
- Use bootstrap first to confirm or establish the correct target, app install, and open app session.
- Once the app session is open and stable, use exploration for inspection, interaction, and verification.
- Start with plain
snapshotif the goal is to read or verify what is visible. - Escalate to
snapshot -ionly if you need refs for interactive exploration or a requested action. - Use
get,is, orfindbefore mutating the UI when a read-only command can answer the question. - End by capturing proof if needed, then
close.
QA modes
- Open-ended bug hunt with reporting: use ../dogfood/SKILL.md.
- Pass/fail QA from acceptance criteria: stay in this skill, start with references/bootstrap-install.md, then use the QA loop in references/exploration.md.
Required references
- For every normal device task, after reading this file, load references/bootstrap-install.md first, then references/exploration.md, before acting.
- Use bootstrap to confirm or establish deterministic setup, especially in sandbox or cloud environments.
- Use exploration once the app session is open and stable.
- Load additional references only when their scope is needed.
Show full SKILL.md (242 more words)Show less
Decision rules
- Use plain
snapshotwhen you need to verify whether text is visible. - Use
snapshot -imainly for interactive exploration and choosing refs. - Use
get,is, orfindwhen they can answer the question without changing UI state. - Use
fillto replace text. - Use
typeto append text. - When a task asks to "go back", use plain
backfor predictable app-owned navigation and reserveback --systemfor platform back gestures or button semantics. - Use
type --delay-msorfill --delay-msfor debounced search fields that drop characters when typed too quickly. - If there is no simulator, no app install, or no open app session yet, switch to
bootstrap-install.mdinstead of improvising setup steps. - Use the smallest unblock action first when transient UI blocks inspection, but do not navigate, search, or enter new text just to make the UI reveal data unless the user asked for that interaction.
- Do not use external lookups to compensate for missing on-screen data unless the user asked for them.
- If the needed information is not exposed on screen, say that plainly instead of compensating with extra navigation, text entry, or web search.
- Prefer
@refor selector targeting over raw coordinates.
Additional references
- Need logs, network, alerts, permissions, or failure triage: references/debugging.md
- Need screenshots, diff, recording, replay maintenance, or perf data: references/verification.md
- Need desktop surfaces, menu bar behavior, or macOS-specific interaction rules: references/macos-desktop.md
- Need remote HTTP transport,
--remote-configlaunches, or tenant leases on a remote macOS host: references/remote-tenancy.md
© callstackincubator, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 7 other files (references) in plugins/vendored/.agents/skills/agent-device of callstackincubator/agent-skills.
- SKILL.md
- references/bootstrap-install.md
- references/coordinate-system.md
- references/debugging.md
- references/exploration.md
- references/macos-desktop.md
- references/remote-tenancy.md
- references/verification.md
Open the folder on GitHubat commit 61e6e7d
Compare with similar skills
Agent Device 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Agent Device this skillcallstackincubator/agent-skills | 1.7k | — | ~1.2k | Automated safety check: Pass | MIT | |
| Phoneagentrounak/PhoneAgent | 798 | — | ~2.2k | Automated safety check: Pass | MIT | |
| Ksafeioannisa/KSafe | 332 | — | ~17k | Automated safety check: Pass | Apache-2.0 | |
| Agent Devicegronxb/codex-relay | 678 | — | ~1.8k | Automated safety check: Pass | Apache-2.0 | |
| Agent DeviceCherryHQ/cherry-studio-app | 4k | — | ~342 | Automated safety check: Pass | AGPL-3.0 | |
| Eas Simulatorexpo/skills | 2.7k | — | ~6.6k | Automated safety check: Notes | MIT |
Similar skills
Ksafe
ioannisa/KSafe
Required before any reply that touches KSafe (by ksafe(...), ksafe.get/put, :ksafe-compose, :ksafe-biometrics), even a 'can KSafe do X?' question or a one-line change that looks like plain Kotlin.
Agent Device
gronxb/codex-relay
Automates interactions for Apple-platform apps (iOS, tvOS, macOS) and Android devices.
Agent Device
CherryHQ/cherry-studio-app
Automates Apple-platform apps (iOS, tvOS, macOS) and Android devices.
- Official
Eas Simulator
expo/skills
Run and control a user's app on a remote iOS/Android simulator hosted on EAS cloud.
Tauri Packaging
bkywksj/knowledge-base
Tauri 打包与分发技能,指导桌面端（Windows/macOS/Linux）与移动端（Android/iOS）的构建、签名和分发。
More from callstackincubator/agent-skills
All 12 skills in this repo- Official
Dogfood
callstackincubator/agent-skills
Systematically explore and test a mobile app on iOS/Android with agent-device to find bugs, UX issues, and other problems.
- Official
Upgrading React Native
callstackincubator/agent-skills
Upgrades React Native apps to newer versions by applying rn-diff-purge template diffs, updating package.json dependencies, migrating native iOS and Android configuration, resolving CocoaPods and…
- Official
React Native Best Practices
callstackincubator/agent-skills
Provides React Native performance optimization guidelines for FPS, TTI, bundle size, memory leaks, re-renders, and animations.
- Official
Create React Native Library
callstackincubator/agent-skills
Scaffolds React Native libraries with create-react-native-library for standalone libraries or local native modules and views.
- Official
React Native Testing
callstackincubator/agent-skills
Write tests using React Native Testing Library (RNTL) v13 and v14 (@testing-library/react-native).
- Official
Assess React Native Migration
callstackincubator/agent-skills
Assesses whether and how an existing mobile product should migrate to React Native.
Related
Categories
Questions about Agent Device
What does Agent Device do?
Automates interactions for Apple-platform apps (iOS, tvOS, macOS) and Android devices. Agent Device is an agent skill from callstackincubator/agent-skills, published by the product's own GitHub organization. Automates interactions for Apple-platform apps (iOS, tvOS, macOS) and Android devices.
When should I use Agent Device?
Agent Device fits situations like: navigating apps; taking snapshots/screenshots; extracting UI info across mobile; desktop targets.
How do I install Agent Device in Claude Code?
Run `npx skills add callstackincubator/agent-skills --skill agent-device -a claude-code`. Or copy the skill folder (plugins/vendored/.agents/skills/agent-device in callstackincubator/agent-skills) into .claude/skills/agent-device in your project. Claude Code loads it when a task matches its description.
How do I install Agent Device in Codex?
Run `npx skills add callstackincubator/agent-skills --skill agent-device -a codex`. Or copy the skill folder (plugins/vendored/.agents/skills/agent-device in callstackincubator/agent-skills) into .agents/skills/agent-device in your project. Codex loads it when a task matches its description.
Can I use Agent Device 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 callstackincubator/agent-skills --skill agent-device -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/agent-device, .gemini/skills/agent-device, .github/skills/agent-device and .opencode/skills/agent-device in your project.
What does Agent Device need to run?
SKILL.md names no scripts, command-line tools or credentials: Agent Device is instructions for the agent only.
Does Agent Device 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 Agent Device safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Agent Device use?
Agent Device is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Agent Device use?
About 1.2k tokens (SKILL.md is roughly 4.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 9.1k tokens, read only when the agent opens those files.
What are the alternatives to Agent Device?
Skills that share tags, products or a category with Agent Device: Phoneagent (rounak/PhoneAgent, 798 stars), Ksafe (ioannisa/KSafe, 332 stars), Agent Device (gronxb/codex-relay, 678 stars) and Agent Device (CherryHQ/cherry-studio-app, 4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Agent Device?
callstackincubator (a GitHub organization, an official publisher) maintains it in callstackincubator/agent-skills, which has 1,664 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on October 6, 2026.
Source: callstackincubator/agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.