.claude/skills/agent-browser-testing/SKILL.md
Browser E2E testing patterns using agent-browser CLI for Mana Vault. Use when running end-to-end tests, verifying UI behavior, testing login flows, or debugging browser-based issues. Covers agent-browser commands, test credentials, login flow, and best practices.
npx skillsauth add WonderPanda/mana-vault agent-browser-testingInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
IMPORTANT: All browser-based end-to-end testing MUST be performed using the
agent-browserCLI tool. Do not use Playwright, Puppeteer, or other browser automation libraries directly.
Default Test Credentials:
[email protected]Password1!Common Commands:
agent-browser open http://localhost:3001 # Open the web app
agent-browser snapshot -i # Get interactive elements with refs
agent-browser click @e2 # Click element by ref from snapshot
agent-browser fill @e3 "text" # Clear and fill input field
agent-browser type @e3 "text" # Type into input field
agent-browser press Enter # Press keyboard key
agent-browser screenshot # Take screenshot
agent-browser screenshot --full # Full page screenshot
agent-browser get text @e1 # Get text content of element
agent-browser wait 2000 # Wait 2 seconds
agent-browser wait "[data-testid='element']" # Wait for element
Typical Login Flow:
agent-browser open http://localhost:3001/login
agent-browser snapshot -i
agent-browser fill "[name='email']" "[email protected]"
agent-browser fill "[name='password']" "Password1!"
agent-browser click "button[type='submit']"
agent-browser wait 2000
agent-browser snapshot -i # Verify logged in state
Best Practices:
snapshot -i after navigation or actions to get current interactive elements with refs[data-testid='...'], [name='...'])--session <name>) to isolate test runs150ms and only increase if needed. Avoid defaulting to long waits like 1000ms or 2000ms.Session Management:
agent-browser --session test1 open http://localhost:3001 # Isolated session
agent-browser --session test1 snapshot -i # Same session
agent-browser session list # List active sessions
Debugging:
agent-browser --headed open http://localhost:3001 # Show browser window
agent-browser console # View console logs
agent-browser errors # View page errors
agent-browser highlight "[selector]" # Highlight element
development
Set up worktrunk (git worktree manager) with dynamic port allocation for Better-T-Stack monorepos using Doppler, Alchemy, and Vite. Use when bootstrapping a new project's worktree workflow, or when asked to "set up worktrunk", "configure worktrees", "add worktree support", or "set up dynamic ports for worktrees". Covers: post-create hooks (Doppler setup, dependency install, .env.worktree generation), env-based port overrides in Vite and Alchemy configs, and dev script modification to source worktree-specific env vars after Doppler injection.
tools
TanStack DB client-side reactive data patterns for Mana Vault. Use when working with useLiveQuery hooks, client-side collections, RxDB/Dexie sync, or any reactive data queries in the web app. Covers hook locations, DB setup, and query builder best practices.
development
React Native and Expo patterns for Mana Vault mobile app. Use when working on the native app in apps/native/, modifying Expo Router routes, HeroUI Native components, or Uniwind styling. Covers project structure and key conventions.
development
React component patterns, styling conventions, and UI guidelines for Mana Vault web app. Use when creating or modifying React components, working with TailwindCSS, shadcn/ui, class-variance-authority, or route components in TanStack Router.