@uicontract/skill 0.2.1 → 0.3.0

package/SKILL.md

@@ -46,7 +46,12 @@ Use the `agentId` from the find result to target the element in the browser.
 **agent-browser:**
 
 ```bash
-agent-browser find testid "settings.billing.pause-subscription.button" click
+# Scoped snapshot to find the element ref:
+agent-browser snapshot -s '[data-agent-id="settings.billing.pause-subscription.button"]'
+# Returns: - button "Pause subscription" [ref=e1]
+
+# Interact using the ref:
+agent-browser click @e1
 ```
 
 **CSS selector (any tool):**
@@ -200,10 +205,12 @@ npx uicontract find "pause subscription" --json
 agent-browser open http://localhost:3000/settings/billing
 ```
 
-**Step 3 -- Interact:**
+**Step 3 -- Target and interact:**
 
 ```bash
-agent-browser find testid "settings.billing.pause-subscription.button" click
+agent-browser snapshot -s '[data-agent-id="settings.billing.pause-subscription.button"]'
+# Returns: - button "Pause subscription" [ref=e1]
+agent-browser click @e1
 ```
 
 ## Key Rules

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uicontract/skill",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Agent skill files for UI Contracts - makes web app UIs machine-readable for AI coding agents",
   "license": "MIT",
   "author": "UIC Contributors",

package/references/browser-tool-bridge.md

@@ -6,17 +6,18 @@ UI Contracts annotates source code with `data-agent-id` attributes. This referen
 
 ### agent-browser
 
-No configuration needed. Use the `find testid` locator to target elements by their agent ID directly.
+Use a scoped snapshot to locate the element ref, then interact using that ref.
 
 ```bash
 # Click an element
-agent-browser find testid "settings.billing.pause-subscription.button" click
+agent-browser snapshot -s '[data-agent-id="settings.billing.pause-subscription.button"]'
+# Returns: - button "Pause subscription" [ref=e1]
+agent-browser click @e1
 
 # Fill a form field
-agent-browser find testid "login.login-form.email.input" fill "user@example.com"
-
-# Check visibility
-agent-browser find testid "settings.billing.pause-subscription.button" visible
+agent-browser snapshot -s '[data-agent-id="login.login-form.email.input"]'
+# Returns: - textbox "Email" [ref=e1]
+agent-browser fill @e1 "user@example.com"
 ```
 
 ### Playwright MCP