A comprehensive automation skill for writing and executing unit, integration, and end-to-end tests across JavaScript, Python, and Swift.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install 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 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 versatile tool designed to standardize software quality assurance across diverse tech stacks. It bridges the gap between different testing ecosystems by providing a unified interface for frameworks like Vitest, Jest, pytest, and Playwright. By integrating this into your Openclaw Skills collection, you can ensure that your code remains robust, maintainable, and free of regressions through automated validation.
Whether you are building a React frontend, a Python backend, or a native Swift application, this skill provides the necessary patterns and commands to implement effective testing strategies. It emphasizes a professional approach to development by prioritizing public API validation and edge-case handling while streamlining the setup of coverage reporting and environment configurations.
Test Runner Use Cases
- Implementing Test-Driven Development (TDD) to drive feature implementation through failing tests.
- Automating cross-browser end-to-end testing to ensure consistent user experiences.
- Validating REST API endpoints and asynchronous data fetching logic.
- Generating detailed code coverage reports to identify untested business logic.
- Mocking external dependencies and global globals to isolate unit tests.
How Test Runner Works
- Identify the project language and select the optimal testing framework (e.g., Vitest for TypeScript or pytest for Python).
- Install the required testing dependencies and initialize configuration files like vitest.config.ts.
- Create test files following the Arrange-Act-Assert pattern to ensure clarity and repeatability.
- Run the test suite using the integrated CLI commands for single runs or continuous watch mode.
- Analyze the output for failures and review coverage reports to verify that all critical paths are protected.
Test Runner Setup
For TypeScript or JavaScript projects using Vitest:
npm install -D vitest @testing-library/react @testing-library/jest-dom
For Python environments using pytest:
uv pip install pytest pytest-cov pytest-asyncio httpx
For E2E testing with Playwright:
npm install -D @playwright/test
npx playwright install
Test Runner Data Schema & Taxonomy
The Test Runner skill organizes testing data and metadata through standardized file structures and configuration formats:
| Component | File Pattern | Description |
|---|---|---|
| Configurations | vitest.config.ts, pytest.ini |
Defines environment settings, globals, and setup files. |
| Test Suites | *.test.ts, test_*.py, *Tests.swift |
Contains the actual test logic and assertions. |
| Coverage Reports | coverage/index.html, htmlcov/ |
Visualizes which lines of code were executed during testing. |
| Test Results | playwright-report/ |
Detailed logs and screenshots for E2E browser tests. |
Test Runner Advanced Features
- Multi-framework support covering unit, integration, and E2E testing levels.
- Integration of Playwright for headed and headless browser automation and debugging.
- Advanced mocking capabilities using Vitest's vi utility for global stubs and spies.
- Automated coverage thresholds to fail builds if code coverage drops below a specific percentage.
- Support for parallel execution and test filtering to optimize performance in large Openclaw Skills projects.
SKILL.md
Loading
Related Openclaw Skills
Project Scaffold
Automate the creation of project structures and boilerplate for web apps, APIs, mobile, and CLI tools using best-practice configurations.
Design Assets
A comprehensive toolkit for automating the generation of app icons, favicons, color palettes, and image transformations using AI and CLI tools.
debug-pro
A systematic debugging framework providing a 7-step protocol and language-specific command references for efficient troubleshooting.
Toggl Time Tracking
A professional time management skill that integrates Toggl Track directly into your AI agent workflow using Openclaw Skills.
Web Deploy
A comprehensive deployment toolkit for launching websites, APIs, and web apps from local dev to production environments.
Audio Speaker Tools
A suite of Python-based utilities for speaker diarization, voice similarity scoring, and automated audio segment extraction.
Vapi Calls
An advanced AI voice assistant skill for executing autonomous phone calls, sales, and bookings via Vapi.
Featured*
