run-tests

Skill: Run Tests

When to Use This Skill

This skill activates when you need to:

• Run tests in an already-configured project
• Execute tests with specific options (coverage, verbose, specific files)
• Run tests in CI/CD or locally
• Understand test execution commands for this project

Prerequisites

This skill assumes tests are already configured. If not, use the pytest-setup or jest-setup skill first.

Step-by-Step Workflow

Step 1: Detect Test Framework and Command

Check for configured test command:

Look in project configuration files:

• package.json → scripts.test
• pyproject.toml → [tool.pytest] or custom scripts
• Makefile → test target
• .github/workflows/ → CI test commands
• tox.ini → test commands

If {{test_command}} is defined:

{{test_command}}

Step 2: Run Tests by Tech Stack

Python (pytest)

Basic test run:

pytest

Verbose output:

pytest -v

With coverage:

pytest --cov=src --cov-report=html --cov-report=term

Specific file:

pytest tests/test_example.py

Specific test:

pytest tests/test_example.py::test_function_name

Pattern matching:

pytest -k "test_user"  # Run tests matching pattern

Markers:

pytest -m "not slow"  # Skip slow tests
pytest -m "integration"  # Only integration tests

Parallel execution:

pytest -n auto  # Requires pytest-xdist

Stop on first failure:

pytest -x

Show print output:

pytest -s

JavaScript/TypeScript (Jest)

Basic test run:

npm test
# or
yarn test

Watch mode:

npm test -- --watch

Coverage:

npm test -- --coverage

Specific file:

npm test -- tests/example.test.js

Pattern matching:

npm test -- --testNamePattern="user"

Update snapshots:

npm test -- --updateSnapshot

Verbose:

npm test -- --verbose