dart-checks-migration

Migrate Dart test suites from package:matcher to package:checks.

139|16|Updated Jan 20, 2026
One-click install
npx skills add https://github.com/kevmoo/dash_skills --skill dart-checks-migration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dart-checks-migration
Source: https://github.com/kevmoo/dash_skills/tree/main/.agent/skills/dart-checks-migration
Command: npx skills add https://github.com/kevmoo/dash_skills --skill dart-checks-migration

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps migrate existing Dart test suites from the older package:matcher library to the more modern and powerful package:checks library, improving test clarity and maintainability.

Core Features & Use Cases

  • Automated Pattern Replacement: Provides direct mappings for common expect assertions to their check equivalents.
  • Async Handling Guidance: Offers specific instructions for correctly migrating asynchronous tests, preventing common pitfalls.
  • Use Case: Refactor a large legacy Dart project's test suite to adopt package:checks, ensuring all tests remain accurate and pass after the migration.

Quick Start

Use the dart-checks-migration skill to convert all expect calls in the test/ directory to use package:checks.

Frequently Asked Questions about dart-checks-migration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate Dart tests from package:matcher to package:checks?

Migrating Dart tests from package:matcher to package:checks involves replacing `expect` assertions with `check` equivalents. This process handles common patterns, asynchronous operations, and complex assertions to improve test code clarity and maintainability.

Why migrate Dart test suites from expect to check assertions?

Migrating from `expect` to `check` assertions modernizes your Dart test suite by adopting `package:checks`, which improves test clarity and maintainability over the older `package:matcher` library. It provides a more powerful syntax for complex assertions.

Do I need to add package:checks as a dev dependency before migrating?

Yes, adding `package:checks` as a dev dependency is required before migrating. This ensures the `check` equivalents for `expect` assertions are available during test execution and refactoring.

Can I use dart-checks-migration for asynchronous Dart tests?

Yes, the migration process offers specific guidance for correctly migrating asynchronous Dart tests. It handles asynchronous operations to prevent common pitfalls when replacing `expect` calls with `check` equivalents.

What are the limitations of migrating complex assertions to package:checks?

While the migration handles common patterns and complex assertions, you should verify all tests pass after refactoring. The process relies on direct mappings, so highly custom `package:matcher` logic may require manual adjustment to achieve accurate `check` equivalents.