@testdriverai/mcp 7.11.136-test → 7.11.138-test

package/ai/skills/testdriver-extract/SKILL.md

@@ -8,7 +8,7 @@ description: Read information from the screen using AI and return it as a string
 
 Extract information from the current screen using AI and return it as a string. Describe what you want in natural language, and the AI reads the screen and returns the matching value — text, numbers, labels, status messages, or any other on-screen content.
 
-Unlike [`assert()`](/v7/assert), which returns a boolean verdict, `extract()` returns the actual value so you can store it, compare it, or feed it into later steps and framework assertions.
+Unlike [`assert()`](/assert), which returns a boolean verdict, `extract()` returns the actual value so you can store it, compare it, or feed it into later steps and framework assertions.
 
 ## Syntax
 
@@ -100,7 +100,7 @@ expect(Number(totalText)).toBeGreaterThan(0);
 <Check>
   **Extract for detailed assertions**
 
-  Use `extract()` when a boolean [`assert()`](/v7/assert) isn't enough and you need the actual value to inspect:
+  Use `extract()` when a boolean [`assert()`](/assert) isn't enough and you need the actual value to inspect:
 
   ```javascript
   const confirmation = await testdriver.extract('the confirmation number');
@@ -214,11 +214,11 @@ describe('Extraction', () => {
 4. The extracted value is returned as a string
 
 <Note>
-  Like [assertions](/v7/making-assertions), `extract()` reads the screen fresh on every call — it is not cached — so it always reflects the current state of the app.
+  Like [assertions](/making-assertions), `extract()` reads the screen fresh on every call — it is not cached — so it always reflects the current state of the app.
 </Note>
 
 ## Related Methods
 
-- [`assert()`](/v7/assert) - Verify screen state with a boolean AI judgment
-- [`find()`](/v7/find) - Locate elements to interact with
-- [`parse()`](/v7/parse) - Detect all UI elements on screen
+- [`assert()`](/assert) - Verify screen state with a boolean AI judgment
+- [`find()`](/find) - Locate elements to interact with
+- [`parse()`](/parse) - Detect all UI elements on screen

package/ai/skills/testdriver-find/SKILL.md

@@ -6,7 +6,7 @@ description: Locate UI elements using natural language
 
 ## Overview
 
-Locate UI elements on screen using AI-powered natural language descriptions. Returns an `Element` object that can be interacted with.
+Find UI elements on the screen with natural language descriptions and AI. This returns an `Element` object. You can interact with the object.
 
 ## Syntax
 
@@ -26,19 +26,19 @@ const element = await testdriver.find(description, options)
   
   <Expandable title="properties">
     <ParamField path="cacheKey" type="string">
-      Custom cache key for storing element location. Use this to prevent cache pollution when using dynamic variables in prompts, or to share cache across tests.
+      A custom cache key to store the element location. Use this to keep the cache clean when you use dynamic variables in prompts. You can also use it to share the cache between tests.
     </ParamField>
     
     <ParamField path="cacheThreshold" type="number" default={0.05}>
-      Similarity threshold (0-1) for cache matching. Lower values require more similarity. Set to -1 to disable cache.
+      The similarity threshold (0-1) for a cache match. A lower value needs more similarity. Set it to -1 to disable the cache.
     </ParamField>
     
     <ParamField path="timeout" type="number" default={10000}>
-      Maximum time in milliseconds to poll for the element. Retries every 5 seconds until found or timeout expires. Defaults to `10000` (10 seconds). Set to `0` to disable polling and make a single attempt.
+      The maximum time in milliseconds to poll for the element. TestDriver tries again each 5 seconds until it finds the element or the timeout ends. The default is `10000` (10 seconds). Set it to `0` to disable the poll and try one time.
     </ParamField>
     
     <ParamField path="confidence" type="number">
-      Minimum confidence threshold (0-1). If the AI's confidence score for the found element is below this value, the find will be treated as a failure (`element.found()` returns `false`). Useful for ensuring high-quality matches in critical test steps.
+      The minimum confidence threshold (0-1). If the confidence score of the found element is less than this value, the find is a failure (`element.found()` returns `false`). Use this to make sure of good matches in critical test steps.
     </ParamField>
     
     <ParamField path="type" type="string">
@@ -50,11 +50,11 @@ const element = await testdriver.find(description, options)
     </ParamField>
     
     <ParamField path="zoom" type="boolean" default={false}>
-      Two-phase zoom mode for better precision in crowded UIs with many similar elements. Disabled by default.
+      A two-phase zoom mode for more precision in full UIs that have many similar elements. It is disabled by default.
     </ParamField>
     
     <ParamField path="verify" type="boolean" default={false}>
-      Enable AI verification of the located element. When `true`, a second AI call checks that the coordinates returned actually correspond to the requested element, catching hallucinated or incorrect positions. Disabled by default for lower latency. Defaults to the global `verify` option set on the [SDK constructor](/v7/client) when not specified per call.
+      This enables AI verification of the found element. When `true`, a second AI call makes sure that the coordinates agree with the correct element. This catches incorrect positions. It is disabled by default for less latency. When you do not set it for each call, it uses the global `verify` option from the [SDK constructor](/client).
     </ParamField>
     
     <ParamField path="ai" type="object">
@@ -85,7 +85,7 @@ const element = await testdriver.find(description, options)
 
 ## Returns
 
-`Promise<Element>` - Element instance that has been automatically located
+`Promise<Element>` - The Element instance that TestDriver found automatically.
 
 ## Examples
 
@@ -141,16 +141,16 @@ console.log('Price text:', price.text);
 
 ## Element Object
 
-The returned `Element` object provides:
+The `Element` object that TestDriver returns gives these:
 
 ### Methods
 
-- `found()` - Check if element was located
+- `found()` - Make a check if TestDriver found the element
 - `click(action)` - Click the element
-- `hover()` - Hover over the element
+- `hover()` - Put the cursor on the element
 - `doubleClick()` - Double-click the element
 - `rightClick()` - Right-click the element
-- `find(newDescription)` - Re-locate with optional new description
+- `find(newDescription)` - Find the element again with an optional new description
 
 ### Properties
 
@@ -163,11 +163,11 @@ The returned `Element` object provides:
 - `width`, `height` - Element dimensions
 - `boundingBox` - Complete bounding box
 
-See [Elements Reference](/v7/elements) for complete details.
+See [Elements Reference](/elements) for complete details.
 
 ### JSON Serialization
 
-Elements can be safely serialized using `JSON.stringify()` for logging and debugging. Circular references are automatically removed:
+You can serialize elements safely with `JSON.stringify()` for logs and for debug. TestDriver removes circular references automatically:
 
 ```javascript
 const element = await testdriver.find('login button');
@@ -197,18 +197,18 @@ console.log(JSON.stringify(element, null, 2));
 // }
 ```
 
-This is useful for:
-- Debugging element detection issues
-- Logging test execution details
-- Sharing element information across processes
-- Analyzing cache performance
+Use this for these:
+- To debug problems with element detection
+- To log the details of the test
+- To share element data between processes
+- To examine the cache performance
 
 ## Best Practices
 
 <Check>
   **Be specific in descriptions**
   
-  More specific descriptions improve accuracy:
+  More specific descriptions make the accuracy better:
   
   ```javascript
   // ✅ Good
@@ -222,7 +222,7 @@ This is useful for:
 <Check>
   **Always check if found**
   
-  Verify elements were located before interacting:
+  Make sure that TestDriver found the elements before you interact with them:
   
   ```javascript
   const element = await testdriver.find('login button');
@@ -250,7 +250,7 @@ This is useful for:
 
 ## Confidence Threshold
 
-Require a minimum AI confidence score for element matches. If the confidence is below the threshold, `find()` treats the result as not found:
+Set a minimum confidence score for element matches. If the confidence is less than the threshold, `find()` makes the result "not found":
 
 ```javascript
 // Require at least 90% confidence
@@ -264,10 +264,10 @@ if (!element.found()) {
 await element.click();
 ```
 
-This is useful for:
-- Critical test steps where an incorrect click could cause cascading failures
-- Distinguishing between similar elements (e.g., multiple buttons)
-- Failing fast when the UI has changed unexpectedly
+Use this for these:
+- Critical test steps. An incorrect click can cause more failures.
+- To tell the difference between similar elements (for example, many buttons)
+- To fail quickly when the UI changed
 
 ```javascript
 // Combine with timeout for robust polling with confidence gate
@@ -278,11 +278,11 @@ const element = await testdriver.find('success notification', {
 ```
 
 <Tip>
-  The `confidence` value is a float between 0 and 1 (e.g., `0.9` = 90%). The AI returns its confidence with each find result, which you can also read from `element.confidence` after a successful find.
+  The `confidence` value is a float between 0 and 1 (for example, `0.9` = 90%). The AI returns its confidence with each find result. You can also read this from `element.confidence` after a good find.
 </Tip>
 ## Element Type
 
-Use the `type` option to hint what kind of element you're looking for. This wraps your description into a more specific prompt for the AI, improving match accuracy — especially when users provide short or ambiguous descriptions.
+Use the `type` option to show which kind of element you look for. This puts your description into a more specific prompt for the AI. It makes the match accuracy better, primarily when a description is short or not clear.
 
 ```javascript
 // Find text on the page
@@ -309,11 +309,11 @@ const el = await testdriver.find('the blue submit button', { type: 'any' });
 | `"any"` | Original description (no wrapping) |
 
 <Tip>
-  This is particularly useful for short descriptions like `"Submit"` or `"Login"` where the AI may not know whether to look for a button, a link, or visible text. Specifying `type` removes the ambiguity.
+  Use this primarily for short descriptions such as `"Submit"` or `"Login"`. In these, the AI can be not sure to look for a button, a link, or visible text. When you give the `type`, the description becomes clear.
 </Tip>
 ## Polling for Dynamic Elements
 
-By default, `find()` polls for up to 10 seconds (retrying every 5 seconds) until the element is found. You can customize this with the `timeout` option:
+By default, `find()` polls for a maximum of 10 seconds (it tries again each 5 seconds) until it finds the element. You can change this with the `timeout` option:
 
 ```javascript
 // Uses default 10s timeout - polls every 5 seconds
@@ -329,18 +329,18 @@ const element = await testdriver.find('login button', { timeout: 0 });
 ```
 
 The `timeout` option:
-- Defaults to `10000` (10 seconds)
-- Retries finding the element every 5 seconds
-- Stops when the element is found or the timeout expires
-- Logs progress during polling
-- Returns the element (check `element.found()` if not throwing on failure)
-- Set to `0` to disable polling and make a single attempt
+- Has a default of `10000` (10 seconds)
+- Tries to find the element again each 5 seconds
+- Stops when it finds the element or the timeout ends
+- Logs the progress during the poll
+- Returns the element (make a check with `element.found()` if it does not throw an error on a failure)
+- Set it to `0` to disable the poll and try one time
 
 ## Zoom Mode
 
-Zoom mode is **disabled by default**. It uses a two-phase approach for better precision when locating elements, especially in crowded UIs with many similar elements.
+Zoom mode is **disabled by default**. It uses a two-phase method for more precision when it finds elements, primarily in full UIs that have many similar elements.
 
-To enable zoom for a specific find call, pass `zoom: true`:
+To enable zoom for a specific find call, give `zoom: true`:
 
 ```javascript
 // Enable zoom for better precision in crowded UIs
@@ -353,22 +353,22 @@ const largeButton = await testdriver.find('big hero button');
 
 ### How Zoom Mode Works
 
-1. **Phase 1**: AI identifies the approximate location of the element
-2. **Phase 2**: A 30% crop of the screen is created around that location
-3. **Phase 3**: AI performs precise location on the zoomed/cropped image
-4. **Result**: Coordinates are converted back to absolute screen position
+1. **Phase 1**: The AI finds the approximate location of the element.
+2. **Phase 2**: TestDriver makes a 30% crop of the screen around that location.
+3. **Phase 3**: The AI does the precise location on the cropped image.
+4. **Result**: TestDriver changes the coordinates back to the absolute screen position.
 
-This two-phase approach gives the AI a higher-resolution view of the target area, improving accuracy when multiple similar elements are close together.
+This two-phase method gives the AI a higher-resolution view of the target area. It makes the accuracy better when many similar elements are near together.
 
 <Tip>
-  You may want to enable zoom with `zoom: true` when:
-  - Targeting small elements in crowded UIs with many similar elements
-  - You need extra precision for closely spaced UI elements
+  Enable zoom with `zoom: true` when:
+  - You target small elements in full UIs that have many similar elements
+  - You need more precision for UI elements that are near together
 </Tip>
 
 ## Verify Mode
 
-Verify mode is **disabled by default**. When enabled, a second AI call checks that the coordinates returned by `find()` actually correspond to the requested element, catching hallucinated or incorrect positions.
+Verify mode is **disabled by default**. When it is enabled, a second AI call makes sure that the coordinates from `find()` agree with the correct element. This catches incorrect positions.
 
 ```javascript
 // Enable verification for critical interactions
@@ -378,13 +378,13 @@ await deleteBtn.click();
 
 ### How Verify Mode Works
 
-1. **Phase 1**: AI locates the element and returns coordinates
-2. **Phase 2**: A second AI call examines the screenshot at those coordinates to confirm the element matches the description
-3. **Result**: If verification fails, the find is retried or marked as not found
+1. **Phase 1**: The AI finds the element and returns coordinates.
+2. **Phase 2**: A second AI call looks at the screenshot at those coordinates. It makes sure that the element agrees with the description.
+3. **Result**: If the verification fails, TestDriver tries the find again or marks it "not found".
 
 ### Combining Zoom and Verify
 
-For maximum accuracy, enable both `zoom` and `verify` together. This is useful for critical interactions where clicking the wrong element could cause cascading failures:
+For the maximum accuracy, enable `zoom` and `verify` together. Use this for critical interactions. A click on the wrong element can cause more failures:
 
 ```javascript
 // Maximum accuracy: zoom for precision + verify to catch hallucinations
@@ -397,13 +397,13 @@ await element.click();
 
 ## Cache Options
 
-When a test completes successfully, the result of each `find()` is cached. On later runs, TestDriver reuses the cached match instead of making a fresh AI call, which significantly speeds up locating the same element. The cache lives in your [dashboard](https://console.testdriver.ai/cache) and is shared across runs — see the [Cache](/v7/cache) page for how matching, thresholds, and invalidation work.
+When a test completes correctly, TestDriver caches the result of each `find()`. On later runs, TestDriver uses the cached match again. It does not make a new AI call. This finds the same element much more quickly. The cache is in your [dashboard](https://console.testdriver.ai/cache). TestDriver shares it between runs. Read the [Cache](/cache) page to see how the match, the thresholds, and the invalidation work.
 
-Control caching behavior to optimize performance, especially when using dynamic variables in prompts.
+Control the cache to make the performance better, primarily when you use dynamic variables in prompts.
 
 ### Custom Cache Key
 
-Use `cacheKey` to prevent cache pollution when prompts contain variables:
+Use `cacheKey` to keep the cache clean when prompts have variables:
 
 ```javascript
 // ❌ Without cacheKey - creates new cache entry for each email value
@@ -425,7 +425,7 @@ await testdriver.find(`order ${orderId} status`, {
 
 ### Cache Threshold
 
-Control how similar a cached result must be to reuse it:
+Control how similar a cached result must be before TestDriver uses it again:
 
 ```javascript
 // Default: 95% similarity required
@@ -449,12 +449,12 @@ await testdriver.find('submit button', {
 ```
 
 <Tip>
-  By default, TestDriver auto-generates a cache key from the SHA-256 hash of your test file. When you modify your test file, the hash changes automatically, invalidating stale cache entries.
+  By default, TestDriver makes a cache key automatically from the SHA-256 hash of your test file. When you change your test file, the hash changes automatically. This makes the old cache entries not valid.
 </Tip>
 
 ### Manual Polling (Alternative)
 
-If you need custom polling logic:
+If you need custom poll logic:
 
 ```javascript
 async function waitForElement(testdriver, description, timeout = 30000) {
@@ -594,10 +594,10 @@ describe('Element Finding', () => {
 
 ## Related Methods
 
-- [`click()`](/v7/click) - Click on found elements
-- [`hover()`](/v7/hover) - Hover over elements
-- [`assert()`](/v7/assert) - Verify element states
-- [Elements Reference](/v7/elements) - Complete Element API
+- [`click()`](/click) - Click on found elements
+- [`hover()`](/hover) - Hover over elements
+- [`assert()`](/assert) - Verify element states
+- [Elements Reference](/elements) - Complete Element API
 
 ---
 

package/ai/skills/testdriver-focus-application/SKILL.md

@@ -6,7 +6,7 @@ description: Bring an application window to the foreground
 
 ## Overview
 
-Bring a specific application window to the foreground and make it the active window for interactions.
+Move a specific application window to the front. Make it the active window for interactions.
 
 ## Syntax
 
@@ -17,12 +17,12 @@ await testdriver.focusApplication(name)
 ## Parameters
 
 <ParamField path="name" type="string" required>
-  Application name (e.g., `'Google Chrome'`, `'Microsoft Edge'`, `'Notepad'`)
+  The application name (for example, `'Google Chrome'`, `'Microsoft Edge'`, `'Notepad'`)
 </ParamField>
 
 ## Returns
 
-`Promise<string>` - Result message
+`Promise<string>` - The result message
 
 ## Examples
 
@@ -288,6 +288,6 @@ describe('Multi-Application Workflow', () => {
 
 ## Related Methods
 
-- [`exec()`](/v7/exec) - Launch applications with PowerShell
-- [`pressKeys()`](/v7/press-keys) - Use Alt+Tab to switch windows
-- [`find()`](/v7/find) - Locate elements in the focused window
+- [`exec()`](/exec) - Launch applications with PowerShell
+- [`pressKeys()`](/press-keys) - Use Alt+Tab to switch windows
+- [`find()`](/find) - Locate elements in the focused window

package/ai/skills/testdriver-generating-tests/SKILL.md

@@ -9,7 +9,7 @@ Start by exploring your app. This is where tests begin: you describe a flow in p
 There are two ways to explore: chatting interactively with your AI assistant through the TestDriver MCP server, or handing a coding agent our instructions file and prompting it to generate a test.
 
 <Info>
-  Both paths need an MCP-capable AI coding assistant. If you don't have one yet, start with **GitHub Copilot** — there's a [free tier](https://github.com/features/copilot/plans), no credit card required. See [Run → Setup](/v7/copilot/running-tests#setup) for the full install and sign-in walkthrough.
+  Both paths need an MCP-capable AI coding assistant. If you don't have one yet, start with **GitHub Copilot** — there's a [free tier](https://github.com/features/copilot/plans), no credit card required. See [Run → Setup](/copilot/running-tests#setup) for the full install and sign-in walkthrough.
 </Info>
 
 ## Instructions for Coding Agents
@@ -65,7 +65,7 @@ When the agent starts a session, a **live preview panel** opens in your editor.
 - **Debug issues** — see exactly what the AI sees
 
 <Note>
-  The live preview panel requires the TestDriver VS Code extension. Set `TD_PREVIEW=ide` in your MCP configuration to enable it. See the [Run page](/v7/copilot/running-tests) for all device and preview options.
+  The live preview panel requires the TestDriver VS Code extension. Set `TD_PREVIEW=ide` in your MCP configuration to enable it. See the [Run page](/copilot/running-tests) for all device and preview options.
 </Note>
 
 ## Interactive Workflow
@@ -186,6 +186,6 @@ describe("Login Flow", () => {
 
 ## Next
 
-<Card title="Learn" icon="brain" arrow="true" horizontal href="/v7/caching">
+<Card title="Learn" icon="brain" arrow="true" horizontal href="/caching">
   Once the agent has explored your app, TestDriver caches what it discovers so your tests replay instantly without re-reasoning over the screen every time.
 </Card>

package/ai/skills/testdriver-hosted/SKILL.md

@@ -51,7 +51,7 @@ Hosted is the default when you follow the Quickstart guide.
 <Card
   title="Try the Quickstart"  
   icon="play"
-  href="/v7/quickstart"
+  href="/quickstart"
 >
   Set your API key and start testing in minutes.
 </Card>
@@ -137,7 +137,7 @@ To prevent tests from failing due to exceeding your license slot limit, we recom
 
 ## When to Consider Self-Hosted
 
-Hosted is perfect for getting started and for teams that want zero infrastructure management. However, you might consider [Self-Hosted](/v7/self-hosted) if you:
+Hosted is perfect for getting started and for teams that want zero infrastructure management. However, you might consider [Self-Hosted](/self-hosted) if you:
 
 - Want to escape per-second billing with a flat license fee
 - Require greater concurrency than offered in Cloud plans
@@ -149,7 +149,7 @@ Hosted is perfect for getting started and for teams that want zero infrastructur
 <Card
   title="Explore Self-Hosted"
   icon="server"
-  href="/v7/self-hosted"
+  href="/self-hosted"
 >
   Learn about self-hosting for unlimited test execution at a flat rate.
 </Card>

package/ai/skills/testdriver-hover/SKILL.md

@@ -6,11 +6,11 @@ description: Hover over elements or coordinates
 
 ## Overview
 
-Move the mouse cursor over elements or specific coordinates without clicking, useful for revealing tooltips, dropdowns, and hover effects.
+Move the mouse cursor onto elements or coordinates without a click. Use this to show tooltips, dropdowns, and hover effects.
 
 ## Element Hover
 
-Hover over a located element.
+Put the cursor on a found element.
 
 ### Syntax
 
@@ -42,7 +42,7 @@ await submenu.click();
 
 ## Coordinate Hover
 
-Hover at specific screen coordinates.
+Put the cursor at screen coordinates.
 
 ### Syntax
 
@@ -273,6 +273,6 @@ describe('Hover Interactions', () => {
 
 ## Related Methods
 
-- [`find()`](/v7/find) - Locate elements to hover
-- [`click()`](/v7/click) - Click after hovering
-- [`mouseDown()`](/v7/click) - Start drag operations
+- [`find()`](/find) - Locate elements to hover
+- [`click()`](/click) - Click after hovering
+- [`mouseDown()`](/click) - Start drag operations

package/ai/skills/testdriver-making-assertions/SKILL.md

@@ -18,7 +18,7 @@ await testdriver.find('first product card in the grid');
 await testdriver.find('dropdown menu labeled "Country"');
 ```
 
-<Info>TestDriver will cache found elements for improved performance on subsequent calls. Learn more about [element caching here](/v7/caching).</Info>
+<Info>TestDriver will cache found elements for improved performance on subsequent calls. Learn more about [element caching here](/caching).</Info>
 
 ### Debugging Found Elements
 
@@ -103,6 +103,6 @@ await testdriver.assert('form has red border');
 
 ## Next
 
-<Card title="Adapt" icon="arrows-rotate" href="/v7/performing-actions">
+<Card title="Adapt" icon="arrows-rotate" href="/performing-actions">
   Drive your app forward by performing actions on the elements you've located and validated.
 </Card>

package/ai/skills/testdriver-mouse-down/SKILL.md

@@ -6,7 +6,7 @@ description: Press the mouse button without releasing it
 
 ## Overview
 
-The `mouseDown()` method presses the mouse button at an element's location without releasing it. This is useful for drag operations, custom gestures, or when you need precise control over mouse events. You can either call it on an [`Element`](/v7/core-concepts/elements) instance or use it directly with a selector.
+The `mouseDown()` method pushes the mouse button at the location of an element. It does not release the button. Use this for drag operations, custom gestures, or when you need precise control of the mouse events. You can call it on an [`Element`](/core-concepts/elements) instance. Or you can use it with a selector.
 
 ## Syntax
 
@@ -30,7 +30,7 @@ When called directly on the AI client:
 
 ## Returns
 
-Returns a `Promise<void>` that resolves when the mouse button is pressed.
+It returns a `Promise<void>`. The promise resolves when TestDriver pushes the mouse button.
 
 ## Examples
 
@@ -147,15 +147,15 @@ test('resizes panel', async () => {
 
 ## Important Notes
 
-- Always pair `mouseDown()` with [`mouseUp()`](/v7/mouse-up) to complete the gesture
+- Always pair `mouseDown()` with [`mouseUp()`](/mouse-up) to complete the gesture
 - The mouse button remains pressed until `mouseUp()` is called
-- Use [`hover()`](/v7/hover) to move the mouse while the button is pressed
+- Use [`hover()`](/hover) to move the mouse while the button is pressed
 - For simple drag operations, consider using `ai()` with a natural language description like `"drag file to folder"`
 
 ## Related Methods
 
-- [`mouseUp()`](/v7/mouse-up) - Release the mouse button
-- [`hover()`](/v7/hover) - Move mouse to element
-- [`click()`](/v7/click) - Full click (mouseDown + mouseUp)
-- [`doubleClick()`](/v7/double-click) - Double-click on element
-- [`rightClick()`](/v7/right-click) - Right-click for context menu
+- [`mouseUp()`](/mouse-up) - Release the mouse button
+- [`hover()`](/hover) - Move mouse to element
+- [`click()`](/click) - Full click (mouseDown + mouseUp)
+- [`doubleClick()`](/double-click) - Double-click on element
+- [`rightClick()`](/right-click) - Right-click for context menu

package/ai/skills/testdriver-mouse-up/SKILL.md

@@ -6,7 +6,7 @@ description: Release the mouse button
 
 ## Overview
 
-The `mouseUp()` method releases the mouse button, completing a drag operation or custom mouse gesture that was started with [`mouseDown()`](/v7/mouse-down). You can call it without parameters to release at the current mouse position.
+The `mouseUp()` method releases the mouse button. It completes a drag operation or a custom mouse gesture that you started with [`mouseDown()`](/mouse-down). Call it without parameters to release the button at the present mouse position.
 
 ## Syntax
 
@@ -21,7 +21,7 @@ None. The mouse button is released at the current cursor position.
 
 ## Returns
 
-Returns a `Promise<void>` that resolves when the mouse button is released.
+It returns a `Promise<void>`. The promise resolves when TestDriver releases the mouse button.
 
 ## Examples
 
@@ -150,15 +150,15 @@ test('selects text with mouse drag', async () => {
 
 ## Important Notes
 
-- `mouseUp()` must be preceded by [`mouseDown()`](/v7/mouse-down) to have an effect
+- `mouseUp()` must be preceded by [`mouseDown()`](/mouse-down) to have an effect
 - Releases the button at the current cursor position
 - Completes any drag or selection operation that was in progress
-- For simple clicks, use [`click()`](/v7/click) instead of mouseDown/mouseUp pair
+- For simple clicks, use [`click()`](/click) instead of mouseDown/mouseUp pair
 
 ## Related Methods
 
-- [`mouseDown()`](/v7/mouse-down) - Press mouse button without releasing
-- [`hover()`](/v7/hover) - Move mouse to element
-- [`click()`](/v7/click) - Complete click (mouseDown + mouseUp)
-- [`doubleClick()`](/v7/double-click) - Double-click on element
-- [`rightClick()`](/v7/right-click) - Right-click for context menu
+- [`mouseDown()`](/mouse-down) - Press mouse button without releasing
+- [`hover()`](/hover) - Move mouse to element
+- [`click()`](/click) - Complete click (mouseDown + mouseUp)
+- [`doubleClick()`](/double-click) - Double-click on element
+- [`rightClick()`](/right-click) - Right-click for context menu

package/ai/skills/testdriver-parse/SKILL.md

@@ -230,7 +230,7 @@ console.log(`Image dimensions: ${result.imageWidth}x${result.imageHeight}`);
 
 ## Related
 
-- [find()](/v7/find) - AI-powered element location
-- [assert()](/v7/assert) - Make AI-powered assertions about screen state
-- [screenshot()](/v7/screenshot) - Capture screenshots
-- [Elements Reference](/v7/elements) - Complete Element API
+- [find()](/find) - AI-powered element location
+- [assert()](/assert) - Make AI-powered assertions about screen state
+- [screenshot()](/screenshot) - Capture screenshots
+- [Elements Reference](/elements) - Complete Element API

package/ai/skills/testdriver-performing-actions/SKILL.md

@@ -6,11 +6,11 @@ description: Perform actions and handle dynamic, async UI so tests adapt to chan
 
 Real apps move, load, and change. Adapt your tests to handle it.
 
-Once you've [generated](/v7/generating-tests) and [learned](/v7/caching) your tests and gotten them [running](/v7/copilot/running-tests), the next challenge is the real world: buttons appear after a spinner, pages navigate, animations play, and content streams in over the network. To keep tests reliable, you need to perform the right actions and handle timing so your tests adapt to how the UI actually behaves instead of breaking.
+Once you've [generated](/generating-tests) and [learned](/caching) your tests and gotten them [running](/copilot/running-tests), the next challenge is the real world: buttons appear after a spinner, pages navigate, animations play, and content streams in over the network. To keep tests reliable, you need to perform the right actions and handle timing so your tests adapt to how the UI actually behaves instead of breaking.
 
 ## Performing Actions
 
-TestDriver provides a variety of actions you can perform, like [clicking](/v7/click), [typing](/v7/type), [hovering](/v7/hover), and [scrolling](/v7/scroll). For a full list, see the [API Reference](/v7/click).
+TestDriver provides a variety of actions you can perform, like [clicking](/click), [typing](/type), [hovering](/hover), and [scrolling](/scroll). For a full list, see the [API Reference](/click).
 
 ```javascript
 // Clicking
@@ -141,8 +141,8 @@ await testdriver.wait(1000);
   For waiting for specific **elements** to appear, prefer `find()` with a `timeout` option. Use `wait()` only for simple time-based pauses.
 </Note>
 
-Once your tests can reliably act on a changing UI and [assert](/v7/making-assertions) the results, the next step is figuring out what happened when something does go wrong.
+Once your tests can reliably act on a changing UI and [assert](/making-assertions) the results, the next step is figuring out what happened when something does go wrong.
 
-<Card title="Next: Debug" icon="bug" href="/v7/debugging-with-screenshots">
+<Card title="Next: Debug" icon="bug" href="/debugging-with-screenshots">
   Use screenshots and run output to see exactly what your test saw and pinpoint failures.
 </Card>

package/ai/skills/testdriver-press-keys/SKILL.md

@@ -6,7 +6,7 @@ description: Press keyboard keys and shortcuts
 
 ## Overview
 
-Press one or more keyboard keys simultaneously, useful for keyboard shortcuts, navigation, and special keys.
+Push one or more keyboard keys at the same time. Use this for keyboard shortcuts, navigation, and special keys.
 
 ## Syntax
 
@@ -17,7 +17,7 @@ await testdriver.pressKeys(keys)
 ## Parameters
 
 <ParamField path="keys" type="Array&lt;string&gt;" required>
-  Array of keys to press simultaneously
+  An array of the keys to push at the same time
 </ParamField>
 
 ## Returns
@@ -343,6 +343,6 @@ describe('Keyboard Navigation', () => {
 
 ## Related Methods
 
-- [`type()`](/v7/type) - Type text
-- [`click()`](/v7/click) - Click elements
-- [`scroll()`](/v7/scroll) - Scroll pages
+- [`type()`](/type) - Type text
+- [`click()`](/click) - Click elements
+- [`scroll()`](/scroll) - Scroll pages