Test Runner Checkpoint Skill

Test Runner Checkpoint

Auto-detects test framework and runs tests, writing results to .checkpoints/test-runner.json.

Workflow

Progress:
- [ ] Step 1: Detect test framework
- [ ] Step 2: Run tests with timeout
- [ ] Step 3: Write checkpoint result

Step 1: Detect Test Framework

| Indicator | Command | |-----------|---------| | package.json with test script | npm test -- --run (preferred), fallback npm test | | pytest.ini or conftest.py | pytest --tb=short | | Cargo.toml | cargo test | | go.mod | go test ./... | | Makefile with test target | make test |

Step 2: Run Tests

timeout 300 <test-command> 2>&1 | tee /tmp/test-output.txt
TEST_EXIT_CODE=${PIPESTATUS[0]}

Step 3: Write Checkpoint Result

mkdir -p .checkpoints
cat > .checkpoints/test-runner.json << 'EOF'
{
  "checkpoint": "test-runner",
  "timestamp": "...",
  "passed": true,
  "framework": "vitest",
  "command": "npm test -- --run",
  "exit_code": 0,
  "stats": {"total": 17, "passed": 17, "failed": 0},
  "failed_tests": [],
  "summary": "All 17 tests passed"
}
EOF

Decision Criteria

Pass: Exit code 0, no test failures

Fail: Any test fails, tests error out, or timeout (300s default)

No tests found: Pass with "framework": "none"

JSON Output Flags (optional)

For complex parsing, use framework JSON output:

Jest: npx jest --json --outputFile=/tmp/results.json
Pytest: pytest --json-report (requires plugin)
Go: go test -json ./...

Agent Skills: Test Runner Checkpoint

Install this agent skill to your local

Skill Files