argent-tv-interact
Installation
SKILL.md
Argent TV (Apple TV + Android TV + Fire TV)
Critical
- A TV is focus-driven, not touch-driven. Drive every interaction with
describe+tv-remote+keyboard; never usegesture-*/ coordinate taps; they don't apply on any TV platform. - Always
describebefore navigating to find the live cursor and your target; never guess focus from a screenshot. The cursor is the focused element; on Vega the toolkit often leavesfocusedfalse and marks the highlighted item[selected], so treat[selected]as the cursor when nothing reports[focused]. - Pass the
udidfromlist-devices: an Apple TV simulator UDID or an Android TV / Vegaserial. Dispatch is automatic from the id; the same tools drive all three. - E2E tests: Vega only. Apple TV and Android TV have no e2e support (a
tap:can pass without doing anything): report that limitation. - Fire TV (Vega) (
platform: "vega"inlist-devices): readreferences/vega.mdbefore driving it. It covers booting and stopping the VVD, Fast Refresh, and debugging the JS runtime.
The navigation loop
describe: find the cursor and your target.tv-remote: move focus toward the target. Prefer one call with a path ending inselect, e.g.{button:["down","right","select"]}; count rows/columns from the list order.describeagain to confirm, or on Apple TVawait-ui-element {condition:"exists", selector:{text:"X", role:"focused"}}. On a miss, repeat.
Tools
describe, tv-remote and keyboard descriptions cover the TV behaviour (focus view, remote keys and paths, text-only typing). Beyond them: