callstackincubator/apex-software-factory / .agents/skills/agent-device
agent-device
VerifiedDrive the Apex Factory app on a leased iOS simulator or Android emulator with agent-device through .agents/scripts/device-lane.sh — open the app, read the accessibility snapshot, tap, type, scroll, verify with wait/is/get, take screenshots, record evidence, and write or replay agent-device .ad scripts (the e2e tests under apps/mobile/e2e/). Use for any interaction with a device, when writing an e2e: test, or when someone says "check it on the simulator", "tap through the app" or "dogfood the app".
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.4 KB |
| SOURCE.md | markdown | 1.4 KB |
| references/android-emulator.md | markdown | 1.5 KB |
| references/dogfood.md | markdown | 933 B |
| references/ios-simulator.md | markdown | 1.6 KB |
SOURCE.md
View on GitHub# Source
- Upstream: https://github.com/callstack/agent-device, commit
`ff259e7950f57967349511c02a2d3c5566fec8e1` (the `0.21.20` release commit, the version pinned in
the root `package.json`). MIT License, Copyright (c) 2026 Callstack.
- Files: `skills/agent-device/SKILL.md` → `SKILL.md`; `skills/ios-simulator/SKILL.md`,
`skills/android-emulator/SKILL.md`, `skills/dogfood/SKILL.md` → `references/`.
- The "Recommended agent rule" comes from https://oss.callstack.com/agent-device/docs/agent-setup
(read 2026-10-04). It lives here, not in `AGENTS.md`, which must stay free of rules.
## Local changes
- Every device command goes through `.agents/scripts/device-lane.sh ad …` on a simlock lease;
the lane adds `--udid`/`--serial`, `--ios-simulator-device-set` and `--session apex-<branch>`.
- Install instructions (`npm install -g agent-device@latest`) and the dogfood version check
are removed: the pinned devDependency is the only agent-device used (safety rule 2).
- Upstream installs with `npx skills add callstack/agent-device`; that is denied here
(`npx *`), so updates are vendored by hand.
- Added: the lane lifecycle, `.ad` replay scripts as the repo's `e2e:` tests, the app's
selectors, and the commands the lane refuses.
## Updating
When the root `package.json` moves agent-device to a new version, take the skill files from the
commit that version was released from, re-apply the local changes above, and update the commit
here.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |