Run behavior tests, run browser tests, execute .test.txt files, run e2e tests with ATR, natural language browser testing, AI browser tests, behavior-driven browser testing, or run browser-based behavior tests using ATR with natural language test specifications.
View on GitHubimyousuf/agentic-test-runner
atr-skills
January 22, 2026
Select agents to install to:
npx add-skill https://github.com/imyousuf/agentic-test-runner/blob/main/skills/atr-behavior/SKILL.md -a claude-code --skill atr-behaviorInstallation paths:
.claude/skills/atr-behavior/# ATR Behavior Testing 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. ## Overview Unlike traditional browser testing that requires precise selectors and step-by-step code, ATR uses an AI agent to: 1. Read natural language test specifications 2. Interpret what actions to perform 3. Execute using browser automation 4. Analyze failures and provide recommendations ## Basic Usage ### Run Single Test ```bash atr run --behavior tests/login.test.txt ``` ### Run Directory of Tests ```bash atr run --behavior tests/e2e/ ``` All `.test.txt` files in the directory are executed. ### With Base URL ```bash atr run --behavior tests/e2e/ --browser-url http://localhost:3000 ``` The base URL is used for relative navigation paths. ## Command Options | 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 File Format 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> ``` ### Example: Login Test ``` 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 ``` ## Running Tests ### Non-H