Webship-js AI Agent for Automated Testing

Image
Webship-js AI Agent for Automated Testing

Webship-js AI Agent for Automated Testing

Now, with three new packages, webship-js brings AI directly into the testing workflow. Gives teams a rich library of ready-to-use Gherkin step definitions, no glue code, no boilerplate.

 

1- Webship-js AI Agent for Claude Code

A Claude Code custom agent specialized in automated website testing using webship-js (Playwright + Cucumber-js).

What It Does

The agent-webship-js agent can:

  • Set up webship-js test projects from scratch
  • Create BDD feature files (Gherkin) for any website
  • Write custom Cucumber step definitions
  • Run test suites and interpret results
  • Debug failing tests (AJAX timing, selectors, rate limiting)
  • Generate HTML test reports

Installation

Quick Install

# Clone the repo
git clone https://github.com/webship/webship-js-ai-agent.git

# Copy agent to your Claude Code agents directory
cp webship-js-ai-agent/.claude/agents/agent-webship-js.md ~/.claude/agents/

Project-Level Install

cp webship-js-ai-agent/.claude/agents/agent-webship-js.md /path/to/project/.claude/agents/

Manual Install

Copy .claude/agents/agent-webship-js.md to either:

  • ~/.claude/agents/ (available globally)
  • <project>/.claude/agents/ (available in specific project)

Usage

In Claude Code, use the agent via the Agent tool:

Use the agent-webship-js agent to test https://example.com/contact

Or reference it in conversations:

@agent-webship-js Set up a test project for https://example.com and create
test cases for the login page.

Example Workflow

  1. Setup: Agent creates project, installs webship-js, configures cucumber.js
  2. Exploration: Agent visits the target page, identifies testable elements
  3. Test Creation: Agent writes .feature files for desktop + mobile
  4. Execution: Agent runs tests, handles failures
  5. Reporting: Agent generates HTML report

Requirements

https://github.com/webship/webship-js-ai-agent

 


 

2- Webship-js Skills for Claude Code

Claude Code skills for automated website testing with webship-js (Playwright + Cucumber-js).

 

Available Skills

SkillCommandDescription
Setup/webship-js-setupInitialize a new webship-js test project
Test/webship-js-testCreate & run BDD tests for a page
Report/webship-js-reportGenerate & analyze HTML test reports
Steps/webship-js-stepsQuick reference for all step definitions

Installation

Quick Install

git clone https://github.com/webship/webship-js-skills.git
cp -r webship-js-skills/.claude/skills/* ~/.claude/skills/

Project-Level Install

cp -r webship-js-skills/.claude/skills/* /path/to/project/.claude/skills/

Install Script

git clone https://github.com/webship/webship-js-skills.git
cd webship-js-skills
bash install.sh            # Install globally
bash install.sh --project /path/to/project  # Install to project

Usage

In Claude Code, invoke skills with slash commands:

/webship-js-setup https://example.com
/webship-js-test /contact
/webship-js-report @desktop
/webship-js-steps form

Workflow Example

# 1. Set up project
/webship-js-setup https://example.com

# 2. Create tests for the contact page
/webship-js-test /contact

# 3. Run tests and get report
/webship-js-report

# 4. Look up step syntax
/webship-js-steps api

Requirements


https://github.com/webship/webship-js-skills 

 


3- Webship-js Claude Plugin (MCP Server)

A Model Context Protocol (MCP) plugin that gives Claude Code native tools for automated website testing with webship-js (Playwright + Cucumber-js).

1. Clone and install dependencies

git clone https://github.com/webship/webship-js-claude-plugin.git
cd webship-js-claude-plugin
npm install

2. Configure in Claude Code

Add to your Claude Code settings (~/.claude/settings.json or project .claude/settings.json):

{
  "mcpServers": {
    "webship-js": {
      "command": "node",
      "args": ["/path/to/webship-js-claude-plugin/src/index.js"]
    }
  }
}

Or use the Claude Code CLI:

claude mcp add webship-js node /path/to/webship-js-claude-plugin/src/index.js

Usage Examples

Once configured, Claude Code can use the tools directly:

Set up a test project

Use webshipjs_setup to create a test project at ./my-tests for https://example.com

Create a feature file

Use webshipjs_create_feature to create a login form validation test

Run tests

Use webshipjs_run_tests to run all @desktop scenarios

Get step reference

Use webshipjs_list_steps with category "form" to see form interaction steps

Requirements


https://github.com/webship/webship-js-claude-plugin 
 


This agent is built for webship-js 2.0. See the webship-js documentation for details.

webship-js is an open-source automated functional acceptance testing framework built on Playwright and Cucumber-js.