From baec841ebfa41aec00293cf4ca0edb99dc59bf4a Mon Sep 17 00:00:00 2001
From: Thiago Brezinski <thiagobrez@gmail.com>
Date: Fri, 15 May 2026 22:45:29 -0500
Subject: [PATCH] chore: add agent-device skill

---
 .agents/skills/agent-device/SKILL.md | 39 ++++++++++++++++++++++++++++
 AGENTS.md                            | 13 ++++++++++
 skills-lock.json                     | 11 ++++++++
 3 files changed, 63 insertions(+)
 create mode 100644 .agents/skills/agent-device/SKILL.md
 create mode 100644 AGENTS.md
 create mode 100644 skills-lock.json

diff --git a/.agents/skills/agent-device/SKILL.md b/.agents/skills/agent-device/SKILL.md
new file mode 100644
index 0000000..7473442
--- /dev/null
+++ b/.agents/skills/agent-device/SKILL.md
@@ -0,0 +1,39 @@
+---
+name: agent-device
+description: Automates Apple-platform apps (iOS, tvOS, macOS) and Android devices. Use when navigating apps, taking snapshots/screenshots, tapping, typing, scrolling, extracting UI info, collecting logs/network/perf evidence, or planning agent-device CLI commands.
+---
+
+# agent-device
+
+Router only. Private setup before using this skill:
+
+```bash
+agent-device --version
+```
+
+If that fails but the user may have installed `agent-device` globally, check the user's configured login/interactive shell and environment before using `npx`. Resolve the command the same way the user would from a normal terminal session, then run the absolute binary path if found. This may require inspecting shell startup behavior or package-manager/global bin locations; do not assume the Codex process `PATH` is the user's `PATH`.
+
+Require `agent-device >= 0.14.0`; older CLIs lack these help topics. If older, stop and tell the user to upgrade the trusted install or approve an exact-version npm command. Do not run `npm install -g agent-device@latest` or `npx -y agent-device@latest` autonomously, and do not include version/upgrade commands in final plans.
+
+Before your first agent-device command or plan, read the version-matched CLI guide:
+
+```bash
+agent-device help workflow
+```
+
+Escalate only when relevant:
+
+```bash
+agent-device help debugging
+agent-device help react-native
+agent-device help react-devtools
+agent-device help remote
+agent-device help macos
+agent-device help dogfood
+```
+
+Default loop: `open -> snapshot/-i -> get/is/find or press/fill/scroll/wait -> verify -> close`.
+
+Use this skill only to route into version-matched CLI help. Let `help workflow` provide exact command shapes, platform limits, and current workflow guidance.
+
+For precise location workflows, read the installed `settings` help before planning so coordinate support and platform limits come from the active CLI version.
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..82efaf3
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,13 @@
+# React Native Bottom Tabs
+
+This is a React Native library for Bottom Tabs using native platform primitives (SwiftUI's TabView on iOS and BottomNavigationView on Android).
+
+It can be used as a standalone library or as a drop-in replacement for the bottom tabs in React Navigation / Expo Router.
+
+It is designed to be a drop-in replacement for JavaScript-based bottom tabs.
+
+## agent-device usage
+
+Use agent-device only for app/device automation tasks. Before planning commands, run `agent-device --version` and read `agent-device help workflow`. For exploratory QA, read `agent-device help dogfood`. For logs, network, traces, or runtime failures, read `agent-device help debugging`. For React Native component trees, props/state/hooks, slow renders, or rerenders, read `agent-device help react-devtools`. For React Native apps, overlays, Metro/Fast Refresh blockers, and routing to React DevTools or debugging evidence, read `agent-device help react-native`.
+
+Use the CLI in the integrated terminal. If `agent-device` is not on PATH but the user installed it globally in another shell, resolve the command the same way the user would from a normal terminal session and run that absolute path instead. This may require inspecting shell startup behavior or package-manager/global bin locations; do not assume the agent process `PATH` is the user's `PATH`. Do not silently fall back to `npx -y agent-device@latest`; ask or use an exact version. MCP is only a discovery/help router and does not expose device automation tools. Prefer `open -> snapshot -i -> act -> re-snapshot -> verify -> close`. Use current refs such as `@e3` for exploration and selectors for durable replay. Keep mutating commands against one session serial. Capture screenshots, logs, network, perf, traces, recordings, and `.ad` replay scripts only when they add evidence.
diff --git a/skills-lock.json b/skills-lock.json
new file mode 100644
index 0000000..7cf1a87
--- /dev/null
+++ b/skills-lock.json
@@ -0,0 +1,11 @@
+{
+  "version": 1,
+  "skills": {
+    "agent-device": {
+      "source": "callstackincubator/agent-device",
+      "sourceType": "github",
+      "skillPath": "skills/agent-device/SKILL.md",
+      "computedHash": "a09ff3456969a416fb35de14484a933e70df307bc11ba77bf3b0a9ea2f723c07"
+    }
+  }
+}