/test

Run behavior tests against a web UI using sitetest — execute runbooks, discover testable behaviors, or capture baselines.

Usage

/test <runbook.yaml> [options]
/test discover <sitecap-dir>

Instructions

When this skill is invoked:

Running a runbook:

npx sitetest run <runbook.yaml> --headless

After the run completes, report the results: steps passed/failed, timing, and any failure reasons. If a capture diff fails, read the diff image to show what changed.

Discovering behaviors:

npx sitetest discover <sitecap-dir> -o /tmp/sitetest-runbooks

After discovery, read the generated YAML runbooks and summarize: how many pages, how many testable elements per page, confidence levels.

With env vars (for auth flows):

npx sitetest run <runbook.yaml> --headless -e <path-to-.env>

Options

Pass additional flags after the runbook path:

• --headless — launch headless Chrome (default for skill)
• --continue-on-error — run all steps even after failures
• --output json — structured JSON output
• --output junit — JUnit XML for CI
• -e <path> — .env file for $VAR resolution in runbooks

Examples

/test tests/login-flow.yaml
/test tests/ --continue-on-error
/test discover ./captures/example.com