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.
A Claude Code custom agent specialized in automated website testing using webship-js (Playwright + Cucumber-js).
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
# 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/
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)
In Claude Code, use the agent via the Agent tool:
Use the agent-webship-js agent to test https://example.com/contactOr reference it in conversations:
@agent-webship-js Set up a test project for https://example.com and create
test cases for the login page.
- Setup: Agent creates project, installs webship-js, configures cucumber.js
- Exploration: Agent visits the target page, identifies testable elements
- Test Creation: Agent writes
.featurefiles for desktop + mobile - Execution: Agent runs tests, handles failures
- Reporting: Agent generates HTML report
- Claude Code CLI
- Node.js >= 20.0
- npm
https://github.com/webship/webship-js-ai-agent
Claude Code skills for automated website testing with webship-js (Playwright + Cucumber-js).
Available Skills
| Skill | Command | Description |
|---|---|---|
| Setup | /webship-js-setup | Initialize a new webship-js test project |
| Test | /webship-js-test | Create & run BDD tests for a page |
| Report | /webship-js-report | Generate & analyze HTML test reports |
| Steps | /webship-js-steps | Quick reference for all step definitions |
Installation
git clone https://github.com/webship/webship-js-skills.git
cp -r webship-js-skills/.claude/skills/* ~/.claude/skills/cp -r webship-js-skills/.claude/skills/* /path/to/project/.claude/skills/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 projectIn 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
# 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- Claude Code CLI
- Node.js >= 20.0
https://github.com/webship/webship-js-skills
A Model Context Protocol (MCP) plugin that gives Claude Code native tools for automated website testing with webship-js (Playwright + Cucumber-js).
git clone https://github.com/webship/webship-js-claude-plugin.git
cd webship-js-claude-plugin
npm installAdd 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.jsOnce configured, Claude Code can use the tools directly:
Use webshipjs_setup to create a test project at ./my-tests for https://example.com
Use webshipjs_create_feature to create a login form validation testUse webshipjs_run_tests to run all @desktop scenariosUse webshipjs_list_steps with category "form" to see form interaction steps- Claude Code CLI
- Node.js >= 20.0
- npm
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.