Run Tests

SkillDev tools

Execute the project test suite with coverage reporting. Use when validating a change.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Run Tests skill

What this skill tells your AI

The instructions your AI receives, as published by stbenjam/skillsaw in tests/fixtures/agentskills/clean/run-tests/SKILL.md and read by ahel’s review.

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.modgo test
  4. Cargo.tomlcargo 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:

MetricValue
TotalN
PassedN
FailedN
CoverageN%

If any tests failed, include the failure output with file paths and line numbers.

Signals

GitHub stars
66
Forks
15
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
run-tests-stbenjam
Source
github.com/stbenjam/skillsaw