# Test Runner

> Run and triage Go tests with correct environment handling; produce compact, actionable failure summaries.

- Skill: `pilinux/test-runner` (Agent Skill)
- Install (CLI): `npx skillmds@latest add pilinux/test-runner`
- Raw SKILL.md: https://api.skillmd.com/api/skills/pilinux/test-runner/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: pilinux (https://skillmd.com/u/pilinux)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/pilinux/test-runner

---


# Test Runner

## When to Use

- Validate changes with unit/integration tests or triage failing test runs.

## Rules

- Use `source setTestEnv.sh` when environment variables are required.
- Focus on the first actionable failure line and include package + test name.
- Prefer targeted test runs (`-run`) over full-suite when iterating.

## Commands

- **Full suite (with test env):** `source setTestEnv.sh && go test -v -cover ./...`
- **Single package:** `source setTestEnv.sh && go test -v -cover ./lib/...`
- **Single test:** `source setTestEnv.sh && go test -v -run TestHashPass ./lib/...`

## Output

- **Result:** pass or fail.
- **Failures:** package, test name, first actionable error lines.
- **Next:** 1-3 focused suggestions (narrow test, inspect file, add mock).

## Related Skills

- `logs-repro-harness`, `linter-runner`, `db-infra-mocks`