A multi-language testing powerhouse for running unit, integration, and E2E tests using industry-standard frameworks.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install zx-test-runner
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install zx-test-runner using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Test Runner?
The Test Runner skill is a comprehensive automation utility designed for developers who need to maintain high code quality across diverse tech stacks. By integrating with Openclaw Skills, this tool provides a unified interface to execute and manage testing suites for TypeScript, JavaScript, Python, and Swift. Whether you are performing localized unit tests or complex end-to-end browser automation, this skill ensures your development lifecycle remains robust and error-free.
It prioritizes modern, high-performance frameworks like Vitest and Playwright while maintaining full support for established tools like Jest and pytest. This skill is essential for maintaining the integrity of public APIs, business logic, and complex state transitions within any Openclaw Skills powered project.
Test Runner Use Cases
- Implementing Test-Driven Development (TDD) workflows to ensure code reliability from the first line.
- Automating regression testing across different programming languages within a single repository.
- Generating detailed code coverage reports to identify untested execution paths.
- Debugging complex asynchronous operations and API endpoints in Python or Node.js.
- Validating user interface components and end-to-end user journeys using Playwright.
How Test Runner Works
- The agent identifies the project language and selects the appropriate testing framework based on predefined preferences.
- Necessary testing dependencies and configurations are initialized (e.g., vitest.config.ts or pytest settings).
- The agent writes test cases following the Arrange-Act-Assert pattern based on specified requirements.
- Tests are executed via the command line, with the agent monitoring for failures or coverage gaps.
- If errors occur, the agent utilizes the Red-Green-Refactor cycle to fix implementation code until all tests pass.
Test Runner Setup
To get started with Test Runner in your Openclaw Skills environment, install the relevant dependencies for your project:
# For TypeScript/JS projects
npm install -D vitest @testing-library/react @testing-library/jest-dom
# For Python projects
uv pip install pytest pytest-cov pytest-asyncio httpx
# For E2E Testing
npm install -D @playwright/test
npx playwright install
Test Runner Data Schema & Taxonomy
The Test Runner skill organizes data through standard framework outputs and specialized reporting files:
| Data Type | Location/Format | Description |
|---|---|---|
| Configuration | vitest.config.ts, jest.config.js |
Defines the testing environment and globals. |
| Test Files | *.test.ts, test_*.py |
Contains the actual test logic and assertions. |
| Coverage Reports | coverage/index.html, htmlcov/ |
Visual representation of code execution metrics. |
| E2E Reports | playwright-report/ |
HTML-based reports including trace logs and screenshots. |
Test Runner Advanced Features
- Support for Mocking and Stubbing: Easily mock global fetches and third-party modules using vi.fn() and vi.stubGlobal.
- Async Testing: First-class support for testing asynchronous code and API endpoints using httpx and AsyncClient.
- Headless & Headed Browser Support: Toggle between background testing and visible browser debugging with Playwright.
- Coverage Thresholds: Configure automated failures if code coverage falls below a specific percentage (e.g., --cov-fail-under=80).
SKILL.md
Loading
Related Openclaw Skills
AI Video Gen
A comprehensive AI-driven pipeline for generating full-length videos from text prompts including visuals, narration, and automated editing.
Free Video Editing AI
An AI-powered video editing skill that automates trimming, background music addition, and 1080p export via cloud GPU rendering.
Pans Meeting Summarizer
An AI-driven sales meeting assistant that converts audio or text into structured minutes, action items, and CRM-ready insights.
Pans CRM Sync
A robust AI sales tool for synchronizing customer data and pipeline statuses across Salesforce and HubSpot platforms.
Google AI Studio — AI Video Generation & Editing
A powerful AI video processing tool that uses Gemini AI to automate video summarization, highlight generation, and professional-grade editing.
AI PPT Generation
An intelligent presentation tool that generates structured PPT files from simple text themes or uploaded resource documents.
Featured*
