Skip to content

claude-world/director-mode-lite / skills/test-runner

test-runner

Verified

Test execution reference: framework detection (pytest/jest/vitest/go/cargo/junit) and correct run/coverage commands, plus failure-analysis steps. Use when running tests, analyzing test failures, or verifying coverage after code changes.

Test Runner Skill

Director Mode Lite - Test Execution Reference


Supported Frameworks

Detect the project's test framework, then use its runner:

LanguageFrameworks
JavaScript/TypeScriptJest, Vitest, Mocha, Playwright
Pythonpytest, unittest
Gogo test
Rustcargo test
JavaJUnit, Maven, Gradle

Test Workflow

Step 1: Detect Framework

Check for configuration files:

  • jest.config.* → Jest
  • vitest.config.* → Vitest
  • pytest.ini or pyproject.toml → pytest
  • go.mod → go test
  • Cargo.toml → cargo test

Step 2: Run Tests

Run tests with the detected framework's command:

# JavaScript/TypeScript
npm test        # or pnpm test / yarn test

# Python
pytest -v

# Go
go test ./...

# Rust
cargo test

For coverage, add the framework's coverage flag (for example pytest --cov, jest --coverage, go test -cover ./..., cargo tarpaulin).

Step 3: Analyze Results

For each failure, capture:

  1. Test name and file location
  2. Expected vs Actual result
  3. Root cause analysis
  4. Suggested fix

Output Format

## Test Results

**Status**: 2 failed, 18 passed (90% pass rate)

### Failed Tests

#### 1. `user.test.ts` - should validate email format
- **Location**: `src/tests/user.test.ts:45`
- **Expected**: `false` for invalid email
- **Actual**: `true`
- **Root Cause**: Regex pattern missing check for domain
- **Fix**: Update regex in `validateEmail()` function

#### 2. `api.test.ts` - should return 401 for unauthorized
- **Location**: `src/tests/api.test.ts:78`
- **Expected**: Status 401
- **Actual**: Status 500
- **Root Cause**: Auth middleware throwing unhandled error
- **Fix**: Add try-catch in auth middleware

### Coverage Summary
- Statements: 85%
- Branches: 72%
- Functions: 90%
- Lines: 84%

TDD Support

When working with the /test-first command:

  1. Red: Write a failing test first
  2. Green: Implement the minimum code to pass
  3. Refactor: Improve without changing behavior
Cycle: Write Test → Run (Fail) → Implement → Run (Pass) → Refactor → Run (Pass)
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 319kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 319kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 319kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 197kUpdated Claude CodeCodexVerifiedInstall