Skip to content

callstackincubator/apex-software-factory / .agents/skills/agent-device

agent-device

Verified

Drive 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".

FileKindSize
SKILL.mdskill md7.4 KB
SOURCE.mdmarkdown1.4 KB
references/android-emulator.mdmarkdown1.5 KB
references/dogfood.mdmarkdown933 B
references/ios-simulator.mdmarkdown1.6 KB
# 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.
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
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: 197kUpdated Claude CodeCodexVerifiedInstall