test-runner

Run targeted pytest, vitest, or jest test subsets with timeouts and fail-fast options.

2|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/hamzaPixl/pixl-ai --skill test-runner-hamzapixl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-runner
Source: https://github.com/hamzaPixl/pixl-ai/tree/main/packages/crew/skills/test-runner
Command: npx skills add https://github.com/hamzaPixl/pixl-ai --skill test-runner-hamzapixl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents long, noisy, or hanging test-suite runs by discovering, categorizing, and executing targeted subsets of tests so developers can get fast, actionable feedback without running the entire suite.

Core Features & Use Cases

  • Language & Framework Detection: Automatically detects Python (pytest) and TypeScript (vitest/jest) projects and selects the appropriate runner.
  • Tiered Discovery & Execution: Discovers test files and markers, classifies tests into smoke/unit/integration/e2e tiers, and runs only the requested scope with sensible timeouts and fail-fast options.
  • Diagnostics & Auto-fixes: Parses failures to identify missing imports, fixtures, config issues, and suggests or applies safe fixes before re-running tests.
  • Use Case: Run quick smoke tests before a commit, run targeted unit tests during development, or trigger background full-suite runs in CI without blocking developer sessions.

Quick Start

Run a fast scope test run to discover and execute unit-level tests for the current repository.

Frequently Asked Questions about test-runner

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run targeted unit tests instead of a full test suite in pytest or vitest?

This Skill discovers test files and classifies them into smoke, unit, integration, and e2e tiers, executing only the requested scope with sensible timeouts and fail-fast options to prevent long test-suite executions.

Can I use test selection for both Python and TypeScript codebases?

Yes, test selection supports both Python and TypeScript codebases by automatically detecting pytest or vitest/jest projects and selecting the appropriate runner for test discovery and execution.

What is the best way to run smoke tests before a commit without blocking my development session?

The best way to run smoke tests before a commit is to execute a fast-scope test run for smoke-level tests, or trigger a background full-suite run in CI, preventing hanging full-suite executions from blocking your developer session.

Why does test automation fail on missing imports and config errors, and can it be auto-fixed?

Test automation fails on missing imports, fixtures, and config errors due to environment misconfigurations, but this Skill parses failures to identify these issues and suggests or applies safe auto-fixes before re-running tests.

How do I enforce timeouts and fail-fast behavior during integration test execution?

Enforce timeouts and fail-fast behavior during integration test execution by categorizing tests into tiered scopes and applying sensible timeout enforcement and fail-fast dev runs specifically for the requested test tier.