Agent Skills: Test Runner

Test Runner

Run tests and return structured results.

Input

scope: string  # Optional: directory, file path, or test name pattern

Process

1. Detect framework from project files (if not provided):

   • spec/ + _spec.rb + .rspec = RSpec
   • test/ + _test.rb = Minitest
   • jest.config.js or *.test.js = Jest/Vitest
   • go.mod + _test.go = Go test
   • pytest.ini or conftest.py = pytest

2. Run tests (scoped if provided, otherwise full suite)

3. Parse output for pass/fail counts and failure details

Framework Commands

| Framework | Run All | Run File | Run Single | |-----------|---------|----------|------------| | RSpec | bundle exec rspec | bundle exec rspec path/to/spec.rb | bundle exec rspec path:LINE | | Minitest | bundle exec rake test | ruby -Itest path/to/test.rb | ruby -Itest path -n test_name | | Jest | npx jest | npx jest path/to/test.js | npx jest path -t "name" | | pytest | pytest | pytest path/to/test.py | pytest path::test_name | | Go | go test ./... | go test ./path/ | go test ./path/ -run TestName |

Output

status: PASS | FAIL
total: int
passed: int
failed: int
failures:        # Only if failed
  - file: string
    line: int
    name: string
    message: string

Error Handling

| Scenario | Action | |----------|--------| | Test framework unclear | Ask user | | Tests fail | Return FAIL with failure details | | Command error | Return FAIL with stderr |