Ship & operateMIT

Deprecation and migration

by Addy Osmani (opens in a new tab) addyosmani/agent-skills

Plans staged deprecation and zero-downtime migrations from replacement through safe removal.

Installation

Skills CLI

Skills CLI command
npx skills@latest add addyosmani/agent-skills --skill deprecation-and-migration

Requires Node.js and npm. Choose your agents in the installer; add -g for a global installation.

Fieldbook review

Reviewed 27 Sept 2026

Uses advisory or compulsory deprecation, then incremental consumer migration and expand/backfill/contract for schemas. It requires production usage evidence, migration tooling, and reversible database migrations, and guards destructive drops until no code references the old shape.

  • LicenceMIT
  • FrontmatterValid name and description
  • Risky patternsNone found
  • Size248 lines
  • Last checked27 Sept 2026 · 6a624f942e09c69863a4219b9bd5d56975026b67b0c70bc83385ffd2120b6142

What it can touch

  • Edits code

    Changes files in your project.

  • Writes docs

    Creates or updates documents such as specs, plans or ADRs.

  • Runs commands

    Runs shell commands such as tests, builds or installs.

Read the source

Fieldbook links to the original instead of copying it, so you always read the version you install.

skills/deprecation-and-migration/SKILL.md on GitHub (opens in a new tab)