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 

 


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.