Help us improve
Share bugs, ideas, or general feedback.
From atr-skills
Runs AI-driven browser behavior tests from natural language .test.txt files using ATR CLI. Supports e2e testing with headless mode, custom viewports, base URLs, and CDP endpoint connections.
npx claudepluginhub imyousuf/agentic-test-runner --plugin atr-skillsHow this skill is triggered — by the user, by Claude, or both
Slash command
/atr-skills:atr-behaviorThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
This skill enables running browser-based behavior tests using ATR's AI-driven automation. Write tests in natural language in `.test.txt` files and let the AI execute them.
Runs E2E browser tests from natural language JSON files using agent-browser, with dev server support, screenshots, and visual regression. Use for UI, browser, or web app testing.
Automates E2E testing and browser interactions with qa-use CLI. Create sessions, navigate pages, snapshot DOM for element refs, perform clicks/fills, and debug test failures.
Automates E2E web app tests using agent-browser CLI with accessibility tree snapshots and ref system for stable interactions like clicks, fills, navigation, and visual checks in bash scripts.
Share bugs, ideas, or general feedback.
This skill enables running browser-based behavior tests using ATR's AI-driven automation. Write tests in natural language in .test.txt files and let the AI execute them.
Unlike traditional browser testing that requires precise selectors and step-by-step code, ATR uses an AI agent to:
atr run --behavior tests/login.test.txt
atr run --behavior tests/e2e/
All .test.txt files in the directory are executed.
atr run --behavior tests/e2e/ --browser-url http://localhost:3000
The base URL is used for relative navigation paths.
| Flag | Description | Default |
|---|---|---|
--behavior <path> | Test file or directory | (required) |
--browser-url <url> | Base URL for tests | from config |
--headless | Run browser headless | true |
--viewport <WxH> | Viewport size | 1920x1080 |
--cdp-endpoint <url> | Connect to existing browser | - |
Test files use .test.txt extension with natural language:
Test: <test name>
Prerequisites:
- <prerequisite 1>
- <prerequisite 2>
Steps:
1. <step 1>
2. <step 2>
3. <step 3>
Expected Results:
- <expected result 1>
- <expected result 2>
Test: User can log in with valid credentials
Prerequisites:
- Application running at http://localhost:3000
- Test user exists: test@example.com / password123
Steps:
1. Navigate to /login
2. Enter "test@example.com" in the email field
3. Enter "password123" in the password field
4. Click the "Sign In" button
5. Wait for the dashboard to load
Expected Results:
- URL contains /dashboard
- Welcome message is visible
- No console errors
atr run --behavior tests/login.test.txt --headless=false
atr run --behavior tests/mobile.test.txt --viewport 375x667
Launch Chrome with remote debugging:
google-chrome --remote-debugging-port=9222
Connect ATR:
atr run --behavior tests/debug.test.txt --cdp-endpoint ws://localhost:9222
The AI agent has access to these browser tools:
Navigation: navigate, back, forward, reload, new-page, select-page, close-page, wait-for
Input: click, fill, hover, press-key, drag, upload-file, handle-dialog
Inspection: snapshot, screenshot, evaluate JavaScript, console logs, network requests
The AI finds elements using multiple strategies:
[aria-label="Sign In"][data-testid="submit-btn"][name="email"][placeholder="Enter email"]#submitBest Practice: Use aria-label or data-testid for reliable element targeting.
When tests fail, ATR captures:
The AI provides root cause analysis and recommendations.
For manual browser exploration before writing tests:
atr browser startatr browser navigate <url>atr browser snapshotatr run --behavior test.test.txtatr browser stopdata-testid attributes when availableConfigure in ~/.atr/config.yaml:
behavior:
base_url: "http://localhost:3000"
browser:
executable: "auto"
headless: true
viewport:
width: 1920
height: 1080
page_timeout: "30s"
action_timeout: "10s"
For detailed test file format and examples, see references/test-file-format.md.