run-tests v1.3A

Immutable. This exact content is served forever at /api/v1/blob/ed604f381859a35f.

---
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:
1. `pyproject.toml` or `pytest.ini` → pytest
2. `package.json` with a `test` script → jest / vitest
3. `go.mod` → `go test`
4. `Cargo.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.