A versatile automated testing skill that detects, writes, and executes tests across various programming languages and frameworks.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install test-runner-codex
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-codex 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 testing solution integrated into the Openclaw Skills ecosystem, designed to help developers maintain high code quality with minimal effort. It intelligently identifies the existing project stack, including languages, package managers, and testing frameworks, to ensure that any new tests or execution workflows align perfectly with established project patterns. By providing a unified interface for tools like Vitest, pytest, and Playwright, it simplifies the process of validating code changes across different environments.
Built to support modern development practices, this skill automates the detection and execution of unit, integration, and end-to-end tests. It emphasizes a native approach, preferring the project's current test stack over introducing new dependencies, which makes it an essential tool for developers utilizing Openclaw Skills to manage complex, multi-language codebases.
Test Runner Use Cases
- Implementing the red-green-refactor cycle to fix bugs efficiently within Openclaw Skills.
- Automating regression testing across TypeScript, Python, and Swift projects.
- Generating and executing end-to-end browser tests using Playwright.
- Increasing code confidence by automating coverage reports and identifying untested edge cases.
- Validating public APIs and business logic through automated integration tests.
How Test Runner Works
- Environmental Analysis: The skill scans the project to detect the programming language, package manager, and any existing test configurations.
- Framework Selection: It identifies the most appropriate testing tool, defaulting to the project's existing framework or suggesting a best-in-class option if none is found.
- Scope Targeting: Initially runs the smallest relevant test scope to diagnose failures quickly before broadening the coverage.
- Iterative Implementation: Follows the red-green-refactor pattern, writing failing tests first and then implementing the minimum code necessary to pass.
- Verification and Refinement: Executes broader test suites after changes are made to ensure system-wide stability within the Openclaw Skills environment.
Test Runner Setup
To use the Test Runner skill effectively, ensure your environment has the necessary dependencies for your specific language. For TypeScript projects, you can initialize the environment using:
npm install -D vitest @testing-library/react @testing-library/jest-dom
For Python projects managed via uv or pip:
uv pip install pytest pytest-cov pytest-asyncio httpx
For Playwright browser testing integration:
npx playwright install
Test Runner Data Schema & Taxonomy
The Test Runner skill organizes its operations around standard testing conventions and metadata:
| Component | Details |
|---|---|
| Config Files | Utilizes project-specific files like vitest.config.ts, jest.config.js, or pytest.ini. |
| Test Patterns | Supports Arrange, Act, Assert (AAA) structures and async test execution. |
| Coverage Output | Supports HTML and terminal-based reports (e.g., --cov-report=html). |
| Framework Mapping | Maps specific languages to preferred tools like Vitest (TS/JS), pytest (Python), and XCTest (Swift). |
Test Runner Advanced Features
- Intelligent auto-detection of project-specific testing stacks to minimize configuration overhead.
- Support for advanced mocking and global stubs via Openclaw Skills integration.
- Cross-platform browser automation support through Playwright integration for UI testing.
- Automated coverage thresholds and failure-under enforcement for CI/CD readiness.
- Specialized testing patterns for React components, async functions, and REST APIs.
SKILL.md
Loading
Related Openclaw Skills
Local Budget Analysis
A privacy-focused financial tool for analyzing CSV bank exports and generating detailed spending reports locally.
Model Checker
A streamlined utility for Openclaw Skills to query and display all currently available internal AI models via a dedicated API.
Speech Coach
An AI-powered public speaking coach that utilizes a structured 15-step curriculum and 25 core methodologies to transform users into confident, persuasive speakers.
Tencent Cloud Diagnostics (txcloud-diagnostics)
An automated diagnostic tool for identifying and resolving anomalies across the Tencent Cloud product ecosystem using real-time monitoring data.
ISP Throttle Detective
A specialized tool for monitoring internet speeds across multiple endpoints to identify time-based or destination-based ISP throttling.
Container Update Advisor
A sophisticated diagnostic tool that scans running Docker containers to identify newer image versions and generate prioritized update reports with changelog insights.
Featured*
