test-migration

Classify existing tests into migration buckets and write test-readiness reports.

9|2|Updated Jun 6, 2026
One-click install
npx skills add https://github.com/app-vitals/shipwright --skill test-migration-app-vitals
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: test-migration
Source: https://github.com/app-vitals/shipwright/tree/main/plugins/shipwright/skills/test-migration
Command: npx skills add https://github.com/app-vitals/shipwright --skill test-migration-app-vitals

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes guesswork from test modernization by comparing the current test suite against an inventory and system blueprint, then assigning each test and infrastructure piece to the right migration action.

Core Features & Use Cases

  • Bucket existing coverage: Classifies tests into reuse, promote, rebuild, trim, or net-new based on layer, framework, speed, and ownership.
  • Protect canonical coverage: Trims only redundant assertions while preserving higher-layer tests that validate wiring and end-to-end outcomes.
  • Audit test infrastructure: Evaluates runners, fixtures, CI workflows, and shared helpers with the same migration logic.
  • Use case: A team preparing a release can identify which tests are healthy, which need deeper assertions, and which gaps still need new coverage before moving phases forward.

Quick Start

Ask the assistant to run the test-migration analysis for the repository and write the resulting report to docs/test-readiness/test-migration.md.

Frequently Asked Questions about test-migration

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

FAQPage Schema
How do I classify existing tests into migration buckets for a refactoring project?

To classify tests into migration buckets, you reconcile existing tests against a prior inventory and system blueprint, assigning each test to reuse, promote, rebuild, trim, or net-new outcomes based on layer, framework, speed, and ownership.

What is test migration analysis and when do I need it for CI workflows?

Test migration analysis evaluates test readiness phase-by-phase by comparing your current suite against a system blueprint. You need it when preparing a release to identify healthy tests, find coverage gaps, and clean up canonical layers before moving phases forward.

How do I trim redundant test assertions without losing end-to-end coverage?

To trim redundant assertions without losing coverage, you protect canonical test layers by removing only duplicated checks while preserving higher-layer tests that validate wiring and end-to-end outcomes across the system.

Does test migration analysis require existing inventory artifacts to run?

Yes, test migration analysis requires reading Phase 1 and Phase 2 artifacts. It uses a prior inventory and system blueprint to evaluate test infrastructure, runners, fixtures, and CI workflows before classifying migration outcomes.

What is the best way to audit test infrastructure readiness for a release?

The best way to audit test infrastructure readiness is to evaluate runners, fixtures, CI workflows, and shared helpers using migration logic, categorizing each component into reuse, promote, rebuild, trim, or net-new buckets to identify gaps before release.

Where should I document the results of a test-readiness and coverage gap analysis?

You should document test-readiness and coverage gap analysis results by writing the classified migration buckets and infrastructure audit outcomes to docs/test-readiness/test-migration.md.