/configure:coverage Skill

/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

Agent Skills: /configure:coverage

Install this agent skill to your local

Skill Files