| name | validate-coverage-threshold |
| description | 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. |
Validate Coverage Threshold
Parses test coverage reports and validates that coverage meets minimum thresholds for quality assurance.
Usage
This skill checks test coverage data against configurable thresholds and returns structured validation results.
Default Thresholds
{
"overall": 80,
"statements": 80,
"branches": 75,
"functions": 80
}
Output Format
All Thresholds Met
{
"status": "success",
"coverage": {
"overall": 87.5,
"statements": 88.2,
"branches": 84.1,
"functions": 89.3
},
"thresholds": {
"overall": 80,
"statements": 80,
"branches": 75,
"functions": 80
},
"passed": true,
"failures": [],
"canProceed": true
}
Below Threshold
{
"status": "warning",
"coverage": {
"overall": 75.3,
"statements": 76.1,
"branches": 72.8,
"functions": 78.2
},
"thresholds": {
"overall": 80,
"statements": 80,
"branches": 75,
"functions": 80
},
"passed": false,
"failures": [
"overall:75.3%<80%",
"statements:76.1%<80%"
],
"uncoveredFiles": [
{"file": "src/utils/helpers.ts", "coverage": 45.2}
],
"canProceed": false,
"details": "Coverage below threshold: 4 metric(s) failed"
}
When to Use
- Quality gate validation (Conductor Phase 3)
- After running tests with coverage
- Pre-commit checks
- CI/CD pipeline validation
Coverage Data Sources
coverage/coverage-summary.json(preferred - c8/Istanbul)- Test output text (fallback)
Requirements
- Coverage data generated by test run
- Run
npm run test -- --coveragefirst