Agent skill
run-comprehensive-tests
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.
Install this agent skill to your Project
npx add-skill https://github.com/BerryKuipers/claude-code-toolkit/tree/main/.claude/api-skills-source/run-comprehensive-tests
SKILL.md
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"
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
validate-typescript
Run TypeScript compiler type-checking (tsc --noEmit) to validate type safety and catch type errors. Returns structured output with error counts, categories (type/syntax/import errors), and affected files. Used for quality gates and pre-commit validation.
validate-coverage-threshold
Validate test coverage meets minimum thresholds (default 80% overall, 80% statements, 75% branches, 80% functions). Parses coverage reports from coverage/coverage-summary.json or test output. Returns pass/fail status with detailed metrics and identifies uncovered files.
quality-gate
Comprehensive quality validation for TypeScript/JavaScript projects - runs TypeScript checks, tests, coverage analysis, build validation, and linting with structured JSON results
validate-build
Run production build validation (npm run build, vite build, tsc) to ensure code compiles and builds successfully. Returns structured output with build status, duration, size metrics, and error details. Used for quality gates and deployment readiness checks.
validate-lint
Run ESLint and Prettier validation to check code style, formatting, and best practices. Returns structured output with error/warning counts, rule violations, and affected files. Used for code quality gates and pre-commit validation.
validate-git-hygiene
Validate git commit messages, branch naming conventions, and repository hygiene. Returns structured output with validation results for commit format (conventional commits), branch naming, and best practices. Used for quality gates and git workflow validation.
Didn't find tool you were looking for?