Agent skill · Testing & QA

actionbook-web-test

Run browser-based web tests against websites using Actionbook CLI. Activate when the user wants to test a website workflow, run smoke tests, verify a user flow, check if a web application works, run regression tests, or validate browser-based interactions. Supports test definition, execution, assertion, reporting, and json-ui visual report generation.

Actionbook1,582★ · +2/wk · 1 repos on radarProfile →
claude-codeships scriptsApache-2.0
Install
npx skills add actionbook/actionbook --skill actionbook-web-test --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 8
SKILL.md size: 38 KB
Bundled scripts: yes
Path: playground/actionbook-web-test/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 1,584 · +2 this week
Language: Rust
Read our review of the source →

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

Review
written from the skill's own SKILL.md · Aug 5, 2026

What it does

The skill enables testing of website workflows by converting YAML-defined tests into declarative workflows executed through the Actionbook CLI. It supports test definition, execution, assertion, reporting, and generation of json-ui visual reports. It activates when users want to test a website workflow, perform smoke or regression tests, verify end-to-end user flows, or monitor a site on a schedule.

How it works

Tests are written as YAML files under tests/ describing a workflow with fields like name, url, actions, env, setup, and steps. Steps map to browser actions (e.g., open, click, fill, type, wait, snapshot) and assertions (e.g., element-exists, text-contains). The skill translates each YAML step into corresponding actionbook browser CLI commands (e.g., actionbook browser open <url>, actionbook browser click "<selector>", actionbook browser wait "<selector>"), executes them in order, and evaluates any provided asserts. It includes pre-flight checks and a recovery process for common failures (selector not found, navigation timeout, element not clickable, etc.), plus automated end-of-test screenshots and embedded report generation. It prioritizes using smart waits (wait-fn) over arbitrary delays and leverages pre-verified selectors from Actionbook to reduce maintenance.

When to use it

Activate when the user: wants to test a website workflow, run smoke or health checks, verify an end-to-end user flow, run regression tests, confirm deployment integrity, monitor functionality on a schedule, or build browser-based test suites without writing Playwright/Cypress code.

What it can touch

The skill uses the Actionbook CLI and related commands (e.g., actionbook browser open, actionbook browser click, actionbook browser wait, actionbook browser snapshot, actionbook browser screenshot, actionbook browser info). It relies on YAML workflows located in tests/ and on pre-fetched selectors via actionbook search and actionbook get. It documents interactions with browser state (visibility, presence, attributes) and navigation through the CLI, but does not reference external files outside the defined CLI interactions and YAML workflow content in tests/.

Caveats

The workflow describes constraints when using the extension backend, such as wait-idle not being supported and certain Web Components interactions being incompatible with fill/type in extension mode. It also notes runtime limitations like Shadow DOM access patterns and iframe cross-origin safety, along with a defined recovery strategy and manual steps when necessary. The license for the skill is Apache-2.0, and the source is actionbook/actionbook.

From the SKILL.md

## When to Use This Skill Activate when the user: - Asks to "test", "verify", "check", or "validate" a website workflow - Wants to run smoke tests or health checks on a web application - Needs to verify a user flow works end-to-end (login, checkout, search, etc.) - Asks to "run regression tests" or "does this still work?" - Wants to confirm a deployment didn't break functionality - Needs to monitor a website's functionality on a schedule - Builds browser-based test suites without writing Playwright/Cypress code ## What actionbook-web-test Provides actionbook-web-test transforms web tests from coded test scripts into **declarative YAML workflows** executed by AI agents via Actionbook CLI. | Benefit | How | |---------|-----| | **AI-native recovery** | When a selector fails, the agent snapshots the live page and finds the equivalent element | | **Actionbook-managed selectors** | Pre-verified selectors with health scores — no manual maintenance | | **Cross-project reusability** | YAML workflows work anywhere Actionbook CLI is installed | | **No test framework required** | No Playwright/Cypress/Jest setup — just `actionbook browser` commands | | **Human-readable tests** | YAML workflows

What's inside
Steps it walks through
  1. When to Use This Skill
  2. What actionbook-web-test Provides
  3. Test Workflow Format
  4. Step Types
  5. Actions → CLI Command Mapping
  6. Step Options
  7. Assertion Types
  8. Assertion Examples
  9. Execution Flow
  10. Step 0: Pre-flight Checks
  11. Step 1: Discover
  12. Step 2: Setup
  13. Step 3: Execute
  14. Step 4: Recover
Ships with 7 files
  • README.md
  • package.json
  • references/assertion-types.md
  • references/report-format.md
  • references/workflow-format.md
  • tests/generate-report.mjs
  • tests/reddit-ui-smoke.yaml
Commands it runs
actionbook browser status
If no browser → open one with setup flags
actionbook browser fetch <url> --format text --timeout 10000 --lite
If fails → report site unreachable, skip all tests for this domain
actionbook browser console --level error --duration 0 &
Capture JS errors throughout the test session
Run all tests
Run smoke tests only
Filter by tag
actionbook --auto-dismiss-dialogs --no-animations browser open <url>
More from actionbook
All skills →
About this skill
What does the actionbook-web-test skill do?

Run browser-based web tests against websites using Actionbook CLI. Activate when the user wants to test a website workflow, run smoke tests, verify a user flow, check if a web application works, run regression tests, or validate browser-based interactions. Supports test definition, execution, assertion, reporting, and json-ui visual report generation.

How do I install it?

Run `npx skills add actionbook/actionbook --skill actionbook-web-test --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From actionbook/actionbook, a repository with 1,584 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going