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.