How do I install the Test Runner skill?

Run npx skillmds@latest add tomevault-io/test-runner-5 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Test Runner skill do?

Run quick/full checks consistently, include smoke, and summarize failures into actionable buckets. Use when this capability is needed. It is listed under Research & Search on SkillMD.

Is Test Runner safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Test Runner?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Test Runner free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Test Runner?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Test Runner by tomevault-io — Agent Skill

Name: Test Runner
Author: tomevault-io

File contents

Read codex.toml (if present) for canonical commands.
Resolve commands (prefer codex.toml, otherwise defaults):
- format: uv run ruff format . --check
- lint: uv run ruff check .
- typecheck: uv run mypy src
- quick tests: test_quick, else test, else uv run pytest -q
- full tests: test_full, else test, else uv run pytest -q
- smoke: smoke, else uv run python scripts/smoke.py if present
Support two modes:
- Quick mode:
  - format/lint
  - feature-scoped or quick tests (test_quick fallback chain)
  - smoke-test
- Full mode:
  - format/lint
  - typecheck
  - full test suite (test_full fallback chain)
  - smoke-test
Always run smoke as its own stage after tests/checks and report it as a separate result bucket.
Summarize results:
- Mode used and commands run
- What passed
- What failed (top 3 failure signatures)
- Smoke result (pass/fail + artifact path when available)
- Likely category: env/setup vs flaky vs deterministic bug vs expectation mismatch
Recommendation logic:
- If unit/tests pass but smoke fails, prioritize packaging/runtime and invoke debug-loop.
- If there are many failures, invoke failure-triage.
- If failures appear intermittent, invoke flaky-test-hunter.

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

Frequently asked questions

Test Runner