testing:test-runner
Provides commands to run, watch, and debug unit and E2E tests with proper server configuration.
Install
mkdir -p .claude/skills/testing-test-runner && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/14521" && unzip -o skill.zip -d .claude/skills/testing-test-runner && rm skill.zipInstalls to .claude/skills/testing-test-runner
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Execute test suites with proper setup and reporting. Use when running tests, checking test status, or debugging test failures.Key capabilities
- →Execute unit tests and E2E tests
- →Run tests with code coverage
- →Manage dev server processes for E2E tests
- →Debug tests with verbose output
- →Identify and resolve common test runner issues
How it works
The skill provides commands for running different types of tests, managing development servers for E2E tests, and debugging. It includes steps for starting and cleaning up server processes and troubleshooting common issues like port conflicts or hanging tests.
Inputs & outputs
When to use testing:test-runner
- →Running unit tests with coverage
- →Executing E2E smoke tests
- →Debugging failing tests or server hangs
About this skill
Test Runner
Execute project test suites with proper configuration.
Quick Commands
# Unit tests
<test-command> # Run all
<test-coverage-command> # With coverage
<test-watch-command> # Watch mode
# E2E tests
<e2e-command> # Run all
<e2e-smoke-command> # Smoke tests only
# Specific tests
<test-runner> <path-to-test-file>
Dev Server Management (for E2E)
# Start (background)
nohup <dev-command> > dev.log 2>&1 &
# Verify
curl -s http://localhost:<port> | head -1
# Run E2E
<e2e-command>
# CRITICAL: Cleanup
pkill -f "<dev-process-name>"
Debugging
# Verbose output
<test-runner> --reporter=verbose <test>
# Playwright UI mode
<playwright-runner> <test> --ui
# Headed mode (see browser)
<playwright-runner> <test> --headed
Common Issues
Server won't start:
lsof -i :<port> # Check port
kill $(lsof -t -i:<port>) # Free port
Tests hanging:
ps aux | grep <process> # Check processes
pkill -f <process> # Kill if needed
Coverage not updating:
rm -rf coverage/ # Clear cache
<test-coverage-command> # Regenerate
When not to use it
- →The task does not involve running or debugging tests
- →The project does not have a defined test suite
Limitations
- →Requires specific test commands and runners to be configured
- →Dev server management is manual and requires cleanup
- →Troubleshooting steps are specific to common issues listed
How it compares
This skill centralizes and standardizes test execution and debugging workflows, providing specific commands and troubleshooting steps that simplify the testing process compared to manual execution.
Compared to similar skills
testing:test-runner side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| testing:test-runner (this skill) | 0 | 1mo | Review | Intermediate |
| e2e-testing-patterns | 8 | 2mo | No flags | Intermediate |
| testing-workflow | 16 | 9mo | Review | Intermediate |
| perf-lighthouse | 13 | 5mo | Review | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
e2e-testing-patterns
wshobson
Master end-to-end testing with Playwright and Cypress to build reliable test suites that catch bugs, improve confidence, and enable fast deployment. Use when implementing E2E tests, debugging flaky tests, or establishing testing standards.
testing-workflow
amo-tech-ai
Comprehensive testing workflow for E2E, integration, and unit tests. Use when testing applications layer-by-layer, validating user journeys, or running test suites.
perf-lighthouse
tech-leads-club
Run Lighthouse audits locally via CLI or Node API, parse and interpret reports, set performance budgets. Use when measuring site performance, understanding Lighthouse scores, setting up budgets, or integrating audits into CI. Triggers on: lighthouse, run lighthouse, lighthouse score, performance audit, performance budget.
xcodebuildmcp
cameroncooke
Official skill for XcodeBuildMCP. Use when doing iOS/macOS/watchOS/tvOS/visionOS work (build, test, run, debug, log, UI automation).
verify
Use when you want to validate changes before committing, or when you need to check all React contribution requirements.
playwright-pro
alirezarezvani
Production-grade Playwright testing toolkit. Use when the user mentions Playwright tests, end-to-end testing, browser automation, fixing flaky tests, test migration, CI/CD testing, or test suites. Generate tests, fix flaky failures, migrate from Cypress/Selenium, sync with TestRail, run on BrowserStack. 55 templates, 3 agents, smart reporting.