agents/skills/test-runner/SKILL.md
Run tests using the project Makefile. Use for executing test suites, running specific tests, and validating code changes.
npx skillsauth add drusifer/via test-runnerInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
One-line summary: Run the project test suite through the Makefile for consistent environment setup.
TLDR:
Use make test to run all tests; use pytest directly (with .venv activated) for targeted runs by file, pattern, or coverage.
On failure: read the error, fix the issue, re-run the specific failing test first, then the full suite.
Used by Neo (*swe test) after implementation changes and by Trin (*qa test) for full verification.
This skill provides standardized test execution using the project's Makefile. All test commands should go through make to ensure consistent environment setup.
make test
Runs the complete test suite with pytest.
source .venv/bin/activate && pytest tests/unit/test_store.py -v
source .venv/bin/activate && pytest -k "test_pattern" -v
source .venv/bin/activate && pytest --cov=via tests/ -v
| Action | Command |
|--------|---------|
| All tests | make test |
| Unit tests only | source .venv/bin/activate && pytest tests/unit/ -v |
| Integration tests | source .venv/bin/activate && pytest tests/integration/ -v |
| Single file | source .venv/bin/activate && pytest tests/unit/test_X.py -v |
| By pattern | source .venv/bin/activate && pytest -k "pattern" -v |
| Verbose output | Add -v or -vv flag |
| Stop on first fail | Add -x flag |
make install)*swe test): Run tests after implementing changes*qa test): Run full test suite for verificationtools
HCI Expert and UX Advocate. Use for user story review, usability testing, HCI evaluation, API/CLI feedback, sprint user review gates, and usability defect filing.
tools
Full sprint implementation cycle. Covers planning, phase Bloop, sprint close, retrospective, and launch. Use *plan sprint to start, then *impl <phase> for each phase.
testing
Switch to a specialized agent persona or invoke a persona directly. Use to delegate work to the right specialist.
development
Invoke project Makefile targets. All targets route through mkf automatically — output is captured to build/build.out, not the context window. Use V= to control verbosity.