run-tests

Detect the test framework, run the test suite, and report pass or failure results.

Updated Jun 4, 2026
One-click install
npx skills add https://github.com/PeteRichardson/skills --skill run-tests-peterichardson
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: run-tests
Source: https://github.com/PeteRichardson/skills/tree/main/run-tests
Command: npx skills add https://github.com/PeteRichardson/skills --skill run-tests-peterichardson

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually figuring out which test command a project uses and interpreting raw test output is repetitive and error-prone, especially when switching between Rust, Swift, and Python codebases. This Skill detects the right framework, runs the appropriate tests, and presents results in a clear, consistent format. ## Core Features & Use Cases - Framework Detection: Inspects Cargo.toml, Package.swift, Xcode projects, pyproject.toml, pytest.ini, and Makefiles to pick the correct test command automatically. - Scoped Test Runs: Runs only tests related to changed files where possible, falling back to the full suite when needed. - Failure Diagnosis: Reports failing test names, assertions, and file locations, then helps investigate the root cause without modifying source code. - Use Case: Before committing changes to a Rust workspace, ask the assistant to run the tests; it executes cargo test, summarizes 42 passed and 0 failed, and confirms the suite is green. ## Quick Start Ask the assistant to run the tests and tell you whether they all pass before you commit your changes.

Frequently Asked Questions about run-tests

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run tests for a Rust, Swift, or Python project automatically?

The Skill detects the framework by inspecting Cargo.toml, Package.swift, Xcode projects, pyproject.toml, or pytest.ini, then runs cargo test, swift test, xcodebuild test, or pytest accordingly. If a Makefile has a test target, it prefers make test.

How to run only tests related to changed files?

For Rust, pass the module path to cargo test; for Swift, use swift test --filter with the target name; for Python, pass specific test files to pytest. If scoping is not possible, the Skill falls back to running the full suite.

Does it work with Xcode projects and Swift Package Manager?

Yes. For SPM packages it runs swift test, and for Xcode projects it runs xcodebuild test with the scheme read from the .xcodeproj file. If the scheme is ambiguous, it asks the user to clarify.

What happens when tests fail?

It reports the number of failures, each failing test name, the failed assertion or panic, and the relevant file and line. It then asks whether you want to investigate and fix the failures or proceed anyway.

Will it modify my code to make failing tests pass?

No. The Skill explicitly does not modify source code or tests to force a pass, does not skip failing tests without permission, and warns before running tests that require external infrastructure like databases or network access.