Skills

RxJS Next Migration

Migrates RxJS 7 code to RxJS Next with a green baseline and a recorded contract.

Install

npx skills add ReactiveX/rxjs --skill rxjs-next-migration -g -a claude-code -y
Repository
ReactiveX/rxjs31.7k
Category
Engineering
Updated
3mo ago
License
Apache-2.0
Context cost
Mediumabout 2,625 tokens
Runs scripts
No, instructions only

What it does

Migrate an RxJS 7 application, library, or test suite to RxJS Next through an agent-led workflow that establishes a green behavioral baseline, makes Observable lifecycle choices explicit, uses @rxjs/migrate only for bounded fixture-proved rewrites, repairs without weakening evidence, and records a versioned migration contract. Use for repository assessment, migration planning or execution, lifecycle review, TestScheduler conversion, or migration closeout.

RxJS 7 to RxJS Next migration

Treat this as reviewed project work, not a codemod run. The objective is an intentional RxJS Next contract backed by the project's own build and behavior evidence. A transformed file, a clean diff, or one passing test is not proof that the migration is complete.

Work through all eight stages in order. Re-enter an earlier stage whenever new evidence changes scope, coverage, or lifecycle intent. Keep the developer involved at every explicit pause.

Non-negotiable rules

  • Read and obey repository-local instructions before acting. Protect existing work and stay within the authorized repository and paths.
  • Establish the RxJS 7 baseline before changing dependencies or source.
  • Never infer platform sharing versus producer-per-direct-subscription behavior from syntax, filenames, operator names, or a currently passing output.
  • Use the installed engine's versioned registry and schemas as authority. Do not reconstruct capability mappings from this Skill or from memory.
  • Run the deterministic engine without writes first. A refusal is a successful safety outcome, not permission to improvise a mechanical rewrite.
  • Preserve the project's test framework by default. Select a framework adapter only when the developer asked for that separate conversion.
  • Do not weaken, skip, delete, or replace a behavioral expectation merely to make the migrated suite green.
  • Do not add RxJS 7 compatibility shims, string-named platform methods, local substitute operators, or runtime generators unless the developer separately authorizes that product work.
  • Keep changes in small coherent batches. Review and verify each batch before widening the scope.
  • Do not call a migration complete while a required command is unknown, unapproved, skipped, or red without an explicitly accepted blocker.

Working record

Read the whole SKILL.md on GitHub

More in Engineering