UI test

The ui-test skill guides your coding agent through testing in a real browser. It can focus on changes in a Git diff or explore an app for functional, accessibility, and responsive layout issues.

Install

npx skills add browserbase/skills --skill ui-test
npm install -g browse

Start your app’s development server for local testing. For remote Browserbase sessions, set BROWSERBASE_API_KEY. If the deployed app requires login, install Cookie sync and prepare an authenticated context.

Test a change

Give your agent the app URL and the scope to test:

Use ui-test to check my current Git diff at http://localhost:3000.
Test the affected user flows, empty and invalid inputs, keyboard navigation,
and mobile layout. Include reproduction steps and screenshots for failures,
and report any tests you couldn't complete.

For broader coverage, ask it to explore a deployed preview:

Use ui-test to explore https://preview.example.com. Focus on product search,
filtering, and navigation. Check error states and narrow-screen layouts,
then produce a report with evidence for each failure.

Review the findings

Your agent reports passed, failed, and skipped tests, with expected and observed behavior for failures. It saves failure screenshots under .context/ui-test-screenshots/ and an HTML report at .context/ui-test-report.html. Review skipped tests as coverage gaps. If a page fails to load, confirm the app server or preview is reachable before rerunning. For remote authentication failures, refresh the context with Cookie sync.

Cookie sync

Prepare authenticated sessions for deployed previews.

Skill source

View test workflows and report examples.

⌘I

Integrations

Install

Test a change

Review the findings

Further reading

Cookie sync

Skill source

​Install

​Test a change

​Review the findings

​Further reading

Cookie sync

Skill source

Install

Test a change

Review the findings

Further reading