| name | run-tests |
| description | Execute the project test suite with coverage reporting. Use when validating a change. |
| compatibility | Requires pytest, jest, or go test |
| metadata | {"author":"dx-team","version":"1.3"} |
Run Tests
Execute the full test suite for the current project, collect coverage
metrics, and report results in a structured format.
When to Use This Skill
Use after making code changes to verify nothing is broken, or when the
user explicitly asks to run tests.
Implementation Steps
Step 1: Detect Test Framework
Identify the test framework by checking these files in order:
pyproject.toml or pytest.ini → pytestpackage.json with a test script → jest / vitestgo.mod → go testCargo.toml → cargo test
Step 2: Run Tests
Execute the test suite with coverage enabled:
- pytest:
pytest tests/ -v --cov=src --cov-report=term-missing
- jest:
npx jest --coverage --verbose
- go test:
go test -v -coverprofile=coverage.out ./...
- cargo:
cargo test -- --nocapture
Step 3: Parse Results
Extract from the test output:
- Total tests run
- Passed / failed / skipped counts
- Coverage percentage by module
- Names and locations of failing tests
Step 4: Report Results
Format a markdown summary:
| Metric | Value |
|---|
| Total | N |
| Passed | N |
| Failed | N |
| Coverage | N% |
If any tests failed, include the failure output with file paths and
line numbers.
