| name | run-comprehensive-tests |
| description | Execute comprehensive test suite (Vitest/Jest) with coverage reporting and failure analysis. Returns structured output with test counts (total/passed/failed), coverage percentage, duration, and detailed failure information. Used for quality gates and CI/CD validation. |
Run Comprehensive Tests
Executes the complete test suite with coverage tracking and provides structured results for workflow decisions.
Usage
This skill runs npm run test (or equivalent) and parses the output for test results and coverage metrics.
Output Format
All Tests Passing
{
"status": "pass",
"summary": {
"total": 45,
"passed": 45,
"failed": 0,
"coverage": 87.5,
"duration": "12.3s"
},
"failures": [],
"canProceed": true
}
Tests Failing
{
"status": "fail",
"summary": {
"total": 45,
"passed": 42,
"failed": 3,
"coverage": 85.2,
"duration": "11.8s"
},
"failures": [
{
"file": "src/components/CharacterCard.test.tsx",
"test": "should render character portrait",
"error": "Expected element to exist",
"line": 42
}
],
"canProceed": false,
"details": "3 test(s) failed"
}
When to Use
- Quality Assurance phase (Conductor Phase 3)
- Before creating pull requests
- After implementing features or bug fixes
- As part of quality-gate workflow
- CI/CD pipeline validation
Test Framework Support
- Vitest (primary)
- Jest (fallback)
- Coverage reporting via c8 or Istanbul
Requirements
- Test framework installed (npm packages)
- Test scripts configured in package.json
- Typical script:
"test": "vitest run --coverage"
