test-run

created	"2025-12-16T00:00:00.000Z"
modified	"2026-05-09T00:00:00.000Z"
reviewed	"2026-04-25T00:00:00.000Z"
allowed-tools	Task, TodoWrite
args	[test-pattern] [--coverage] [--watch]
argument-hint	[test-pattern] [--coverage] [--watch]
description	Universal test runner that auto-detects pytest, vitest, jest, cargo test, or go test. Use when running tests, testing a specific file or pattern, running with coverage, watch-mode dev loops, or running tests without specifying a framework.
name	test-run

When to Use This Skill

Use this skill when...	Use test-quick instead when...
Running tests with auto-detected framework (pytest, vitest, jest, cargo, go)	You only want fast unit tests for sub-30s feedback
Running a specific file or pattern with full framework defaults	Iterating on a single failing spec (use test-focus)
Generating coverage in the standard run	Running the full pyramid before a PR (use test-full)
Starting a watch-mode dev loop across the project	Triaging existing test results (use test-analyze)

Context

• Project indicators: !find . -maxdepth 1 \( -name 'pyproject.toml' -o -name 'package.json' -o -name 'Cargo.toml' -o -name 'go.mod' \)
• Test directories: !find . -maxdepth 1 -type d \( -name 'tests' -o -name 'test' -o -name '__tests__' -o -name 'spec' \)
• Package.json test script: !grep -A2 '"test"' package.json
• Pytest config: !grep -A5 '\[tool.pytest' pyproject.toml

Parameters

• $1: Optional test pattern or specific test file/directory
• --coverage: Enable coverage reporting
• --watch: Run tests in watch mode

Your task

Delegate this task to the test-runner agent.

Use the Agent tool with subagent_type: test-runner to run tests with the appropriate framework. Pass all the context gathered above and the parsed parameters to the agent.

The test-runner agent should:

1. Detect project type and test framework:

   • Python: pytest, unittest, nose
   • Node.js: vitest, jest, mocha
   • Rust: cargo test
   • Go: go test

2. Run appropriate test command:

   • Apply test pattern if provided
   • Enable coverage if requested
   • Enable watch mode if requested

3. Analyze results:

   • Parse test output for pass/fail counts
   • Identify failing tests with clear error messages
   • Extract coverage metrics if available

4. Provide concise summary:

   Tests: [PASS|FAIL]
   Passed: X | Failed: Y | Duration: Zs
   
   Failures (if any):
   - test_name: Brief error (file:line)
   
   Coverage: XX% (if requested)
   

5. Suggest next actions:

   • If failures: specific fix recommendations
   • If coverage gaps: areas needing tests
   • If slow: optimization suggestions

Provide the agent with:

• All context from the section above
• The parsed parameters (pattern, --coverage, --watch)
• Any specific test configuration detected

The agent has expertise in:

• Multi-framework test execution
• Test failure analysis and debugging
• Coverage reporting and gap identification
• Tiered test execution (unit, integration, e2e)