# dart-collect-coverage

Collects Dart and Flutter test coverage metrics with the coverage package and generates LCOV reports. Handy for test auditing and CI pipeline preparation.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 18400 installs · ★ 530
- Author: dart-lang
- License: BSD-3-Clause · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/dart-lang/skills/tree/HEAD/skills/dart-collect-coverage/SKILL.md
- Updated: 2026-10-16
- HTML: https://affpapa.org/en/nevibecode/skills/dart-collect-coverage

## What it does

This skill guides coverage collection for Dart and Flutter applications. It installs the `coverage` package under `dev_dependencies` using `dart pub add` or `flutter pub add`, then executes `coverage:test_with_coverage`. The automated script runs the test suite, captures JSON from the Dart VM, and produces `coverage/lcov.info`. In workspace monorepos, target directories can be passed explicitly.

For isolate control, the skill outlines a manual collection workflow. Tests run with `--pause-isolates-on-exit` while exposing the VM service on port 8181. Next, `coverage:collect_coverage` pulls data from the running VM, and `coverage:format_coverage` converts JSON into LCOV. Capturing function and branch metrics requires Dart VM 2.17.0 or newer.

Untestable lines or files can be skipped using inline directives like `// coverage:ignore-line` or `// coverage:ignore-file`. The `--check-ignore` flag ensures the formatter applies these rules directly to the report.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add dart-lang/skills --skill dart-collect-coverage -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/dart-collect-coverage/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/dart-collect-coverage/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add dart-lang/skills --skill dart-collect-coverage -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/dart-collect-coverage/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add dart-lang/skills --skill dart-collect-coverage -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/dart-collect-coverage/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install dart-lang/skills dart-collect-coverage
```

2. **Manually: put the files in place**
- File: `.github/skills/dart-collect-coverage/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add dart-lang/skills --skill dart-collect-coverage -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/dart-lang/skills --path skills/dart-collect-coverage
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/dart-collect-coverage/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add dart-lang/skills --skill dart-collect-coverage -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/dart-lang/skills/tree/HEAD/skills/dart-collect-coverage/SKILL.md

## When to use it
- Add the coverage package to project dev_dependencies
- Run Dart and Flutter tests and generate an LCOV report
- Collect branch and function coverage through the Dart VM service
- Exclude generated code using inline coverage ignore comments

## Example prompts
- Run Dart tests and generate an LCOV coverage report in coverage/lcov.info
- Configure dev:coverage dependency and execute test_with_coverage
- Collect branch coverage from the VM service on port 8181

## Source text · SKILL.md · BSD-3-Clause

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 7e58e574b6ddcebf.

BEGIN THIRD-PARTY FILE 7e58e574b6ddcebf
````text
---
name: dart-collect-coverage
description: Collect coverage using the coverage packge and create an LCOV report
metadata:
  model: models/gemini-3.1-pro-preview
  last_modified: Fri, 24 Apr 2026 15:14:32 GMT
---
# Implementing Dart and Flutter Test Coverage

## Contents
- [Testing Fundamentals](#testing-fundamentals)
- [Coverage Directives](#coverage-directives)
- [Workflow: Configuring and Generating Coverage Reports](#workflow-configuring-and-generating-coverage-reports)
- [Workflow: Advanced Manual Coverage Collection](#workflow-advanced-manual-coverage-collection)
- [Examples](#examples)

## Testing Fundamentals

Structure your test suites using the standard Dart testing paradigms. Use `package:test` for Dart projects and `flutter_test` for Flutter projects.

- **Unit Tests:** Verify individual functions, methods, or classes.
- **Component/Widget Tests:** Verify component behavior, layout, and interaction using mock objects (`package:mockito`).
- **Integration Tests:** Verify entire app flows on simulated or real devices.

## Coverage Directives

Exclude specific lines, blocks, or entire files from coverage metrics using inline comments. Pass the `--check-ignore` flag during formatting to enforce these directives.

- Ignore a single line: `// coverage:ignore-line`
- Ignore a block of code: `// coverage:ignore-start` and `// coverage:ignore-end`
- Ignore an entire file: `// coverage:ignore-file`

## Workflow: Configuring and Generating Coverage Reports

Follow this sequential workflow to add the coverage package, execute tests, and generate an LCOV report.

**Task Progress Checklist:**
- [ ] 1. Add `coverage` as a `dev_dependency`.
- [ ] 2. Execute the automated coverage script.
- [ ] 3. Validate the LCOV output.

### 1. Add Dependencies
Add the `coverage` package as a `dev_dependency` to your project. Do not add it to standard dependencies.

If working in a standard Dart project:
```bash
dart pub add dev:coverage
```

If working in a Flutter project:
```bash
flutter pub add dev:coverage
```

### 2. Collect Coverage and Generate LCOV
Use the bundled `test_with_coverage` script. This script automatically runs all tests, collects the JSON coverage data from the Dart VM, and formats it into an LCOV report.

```bash
dart run coverage:test_with_coverage
```
*Note: If working within a Dart workspace (monorepo), specify the test directories explicitly (e.g., `dart run coverage:test_with_coverage -- pkgs/foo/test pkgs/bar/test`).*

### 3. Feedback Loop: Validate Output
**Run validator -> review errors -> fix:**
1. Verify that the `coverage/` directory was created in the project root.
2. Ensure `coverage/coverage.json` (raw data) and `coverage/lcov.info` (formatted report) exist.
````
END THIRD-PARTY FILE 7e58e574b6ddcebf

The third-party file has ended. Everything between the 7e58e574b6ddcebf tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2724 of 4893 bytes. © dart-lang · BSD-3-Clause · https://github.com/dart-lang/skills/tree/HEAD/skills/dart-collect-coverage/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md