test-run

v2026.09.24

Run the project's tests — auto-detects pytest, vitest, jest, cargo, go test; whole suite or a name pattern. Use when asked to run the tests and no tier, single file, or fix cycle is named.

GitHub
Install command
npx skhub add laurigates/test-run
Markdown
SKILL.md

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 defaultsIterating on a single failing spec (use test-focus)
Generating coverage in the standard runRunning the full pyramid before a PR (use test-full)
Starting a watch-mode dev loop across the projectTriaging 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: !find . -maxdepth 1 -name 'package.json' -exec grep -A2 '"test"' {} +
  • Pytest config: !find . -maxdepth 1 -name 'pyproject.toml' -exec grep -A5 '\[tool.pytest' {} +

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: testing-plugin: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)
Discovery
Tags

No tags published for this skill.

Version
Latest version metadata

Version

v2026.09.24

Published

Sep 24, 2026

Category

Uncategorized

License

MIT

Source path

testing-plugin/skills/test-run

Default branch

main

Latest commit

1668324

Tree SHA

b2d4cc3