laurigates/configure-coverage

/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:

1. Install coverage provider (e.g., @vitest/coverage-v8, pytest-cov)
2. Update config file with thresholds, reporters, exclusions
3. Add scripts to package.json or pyproject.toml
4. 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

See Also

• /configure:tests - Configure testing frameworks
• /test:coverage - Run tests with coverage
• /configure:all - Run all compliance checks
• Codecov documentation: https://docs.codecov.com
• pytest-cov documentation: https://pytest-cov.readthedocs.io