/configure:coverage

Check and configure code coverage thresholds and reporting for test frameworks.

When to Use This Skill

Use this skill when...	Use another approach when...
Setting up coverage thresholds for Vitest, Jest, pytest, or Rust	Running tests with coverage (`/test:coverage`)
Configuring coverage reporters (text, JSON, HTML, lcov)	Configuring the test framework itself (`/configure:tests`)
Adding Codecov or Coveralls integration to CI/CD	Analyzing test failures (test-runner agent)
Auditing coverage configuration compliance across a project	Writing individual test cases
Adjusting coverage threshold percentages	Configuring general CI/CD workflows (`/configure:workflows`)

Context

Project root: !pwd
Package files: !find . -maxdepth 1 \( -name 'package.json' -o -name 'pyproject.toml' -o -name 'Cargo.toml' \)
Vitest config: !find . -maxdepth 1 -name 'vitest.config.*'
Jest config: !find . -maxdepth 1 -name 'jest.config.*'
Coverage dir: !find . -maxdepth 1 -type d -name 'coverage'
Codecov config: !find . -maxdepth 1 \( -name 'codecov.yml' -o -name '.codecov.yml' \)
Project standards: !find . -maxdepth 1 -name '.project-standards.yaml'

Parameters

Parse from command arguments:

--check-only: Report compliance status without modifications (CI/CD mode)
--fix: Apply fixes automatically without prompting
--threshold <percentage>: Set coverage threshold (default: 80)

Default threshold: 80% (lines, branches, functions, statements)

Supported frameworks:

Vitest: @vitest/coverage-v8 or @vitest/coverage-istanbul
Jest: Built-in coverage with --coverage
pytest: pytest-cov plugin
Rust: cargo-llvm-cov or cargo-tarpaulin

Execution

Execute this code coverage compliance check:

Step 1: Detect test framework and coverage configuration

Check for framework indicators:

Indicator	Framework	Coverage Tool
`vitest.config.*` with coverage	Vitest	@vitest/coverage-v8
`jest.config.*` with coverage	Jest	Built-in
`pyproject.toml` [tool.coverage]	pytest	pytest-cov
`.cargo/config.toml` with coverage	Rust	cargo-llvm-cov

Use WebSearch or WebFetch to verify latest versions of coverage tools before configuring.

Step 2: Analyze current coverage state

For the detected framework, check configuration completeness:

Vitest:

Coverage provider configured (v8 or istanbul)
Coverage reporters configured (text, json, html, lcov)
Thresholds set for lines, functions, branches, statements
Exclusions configured (node_modules, dist, tests, config files)
Output directory specified

Jest:

collectCoverage enabled
coverageProvider set (v8 or babel)
collectCoverageFrom patterns configured
coverageThresholds configured
coverageReporters configured

pytest:

pytest-cov installed
[tool.coverage.run] section exists
[tool.coverage.report] section exists
Coverage threshold configured (--cov-fail-under)

Rust (cargo-llvm-cov):

cargo-llvm-cov installed
Coverage configuration in workspace
HTML/LCOV output configured

Step 3: Generate compliance report

Print a formatted compliance report:

Code Coverage Compliance Report
================================
Project: [name]
Framework: [Vitest 2.x | pytest 8.x | cargo-llvm-cov 0.6.x]

Coverage Configuration:
  Provider                @vitest/coverage-v8        [CONFIGURED | MISSING]
  Reporters               text, json, html, lcov     [ALL | PARTIAL]
  Output directory        coverage/                  [CONFIGURED | DEFAULT]
  Exclusions              node_modules, dist, tests  [CONFIGURED | INCOMPLETE]

Thresholds:
  Lines                   80%                        [PASS | LOW | NOT SET]
  Branches                80%                        [PASS | LOW | NOT SET]
  Functions               80%                        [PASS | LOW | NOT SET]
  Statements              80%                        [PASS | LOW | NOT SET]

CI/CD Integration:
  Coverage upload         codecov/coveralls          [CONFIGURED | MISSING]
  Artifact upload         coverage reports           [CONFIGURED | MISSING]

Overall: [X issues found]

If --check-only, stop here.

Step 4: Configure coverage (if --fix or user confirms)

Apply coverage configuration based on detected framework. Use templates from REFERENCE.md:

Install coverage provider (e.g., @vitest/coverage-v8, pytest-cov)
Update config file with thresholds, reporters, exclusions
Add scripts to package.json or pyproject.toml
Configure CI/CD with Codecov upload and artifact storage

Step 5: Update standards tracking

Update .project-standards.yaml:

standards_version: "2025.1"
last_configured: "[timestamp]"
components:
  coverage: "2025.1"
  coverage_threshold: 80
  coverage_provider: "[v8|istanbul|pytest-cov|llvm-cov]"
  coverage_reporters: ["text", "json", "html", "lcov"]
  coverage_ci: "codecov"

Step 6: Print final report

Print a summary of changes applied, scripts added, and next steps for verifying coverage.

For detailed configuration templates, see REFERENCE.md.

Agentic Optimizations

Context	Command
Quick compliance check	`/configure:coverage --check-only`
Auto-fix all issues	`/configure:coverage --fix`
Custom threshold	`/configure:coverage --fix --threshold 90`
Check coverage config exists	`find . -maxdepth 1 -name 'vitest.config.' -o -name 'jest.config.' 2>/dev/null`
Verify coverage directory	`test -d coverage && echo "EXISTS"`

Flags

Flag	Description
`--check-only`	Report status without offering fixes
`--fix`	Apply all fixes automatically without prompting
`--threshold <percentage>`	Set coverage threshold (default: 80)

Examples

# Check compliance and offer fixes
/configure:coverage

# Check only, no modifications
/configure:coverage --check-only

# Auto-fix with custom threshold
/configure:coverage --fix --threshold 90

Error Handling

No test framework detected: Suggest running /configure:tests first
Coverage provider missing: Offer to install
Invalid threshold: Reject values <0 or >100
CI token missing: Warn about Codecov/Coveralls setup

configure-coverage