name: ui-test-runner description: When asked to run UI tests for URLS4IRL, this skill will be used. argument-hint: Marker Name
UI tests are run against pre-built Vite assets using make targets.
- Find all UI test markers listed in @pytest.ini. Any UI test set will have a marker ending in *_ui.
- If the user passes a specific marker to run, then run this marker: $0_ui.
- Run UI tests using the built make target. Replace MARKER with the actual marker:
make test-marker-parallel-built m=MARKER
This runs start-built (tears down stack, rebuilds with pre-built Vite assets) then runs the tests. Always use built targets for UI tests — never the dev server.
- Verify the tests run.
- Check for any failures.
- Report any test failures to the user with relevant error lines from the test.
- Investigate the test failures and hypothesize why they are occurring. Never dismiss a failure as "pre-existing" or "flaky" because the test file wasn't modified on the current branch. Current changes can break tests indirectly (shared fixtures, CSS/selector changes, templates, timing, imports). For every failure: read the traceback, check if branch changes could affect the failing path, and either fix or confirm unrelated by rerunning in isolation 2-3 times.