← Explore all skills

SOFTWARE ARCHITECTURE / addyosmani

Deprecation and Migration Planning

Plan incremental retirement of APIs, systems and database schema with consumer migration evidence.

“Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when migrating a database schema in production, such as renaming or dropping a column without downtime (expand/contract). Use when deciding whether to maintain or sunset existing code.”

01 / THE REASONING

Why this made the selection.

  • The guide distinguishes advisory from compulsory deprecation and assigns migration responsibility to infrastructure owners rather than merely announcing a deadline.
  • Sequence an expand-contract column migration across mixed application versions.

02 / THE REVIEW RECORD

What we actually inspected.

Source review has boundaries.
A clear record is more useful than a “safe” badge.

Material inspected

  • skills/deprecation-and-migration/SKILL.md
  • LICENSE
  • README.md

Our findings

  • The guide distinguishes advisory from compulsory deprecation and assigns migration responsibility to infrastructure owners rather than merely announcing a deadline.

Not established by this review

  • Third-party instructions and helpers were not executed; service access, host compatibility and outcomes remain untested.
  • Not executed: it was not installed or run.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

Add a skill to your workflow.

Upstream setup instructions ↗

DOCUMENTED COMMAND

npx skills add addyosmani/agent-skills/skills/deprecation-and-migration

Run in your terminal to choose your AI tools, project or global scope, and installation method. This short command follows the current upstream version; the review covers the revision shown above.

Optional: install the reviewed revision

Keeps the original source and installer version where recorded, while leaving your AI tools and installation scope for you to choose.

npx skills add https://github.com/addyosmani/agent-skills/tree/aeac41d4d005999432bb7312f7ff06383a91d59d/skills/deprecation-and-migration
  1. Install the pinned directory interactively and retain its referenced files; inspect the source before granting tool access.
  2. Inventory consumers and compatibility obligations, add the replacement alongside the old form, verify migration and reserve deletion for the final contract phase.

Before you start

  • Repository and consumer inventory, migration tooling and representative validation environment

04 / FOLLOW THE EVIDENCE

The source trail.

Our notes are separate from the original resource.
Check upstream before adopting a new version.

  1. https://github.com/addyosmani/agent-skills/blob/aeac41d4d005999432bb7312f7ff06383a91d59d/skills/deprecation-and-migration/SKILL.md

    Supports: summary, review, install, access, limitations

  2. Pinned LICENSE ↗Checked

    https://github.com/addyosmani/agent-skills/blob/aeac41d4d005999432bb7312f7ff06383a91d59d/LICENSE

    Supports: license

  3. Pinned README.md ↗Checked

    https://github.com/addyosmani/agent-skills/blob/aeac41d4d005999432bb7312f7ff06383a91d59d/README.md

    Supports: summary, review, install, access, limitations

  4. https://raw.githubusercontent.com/addyosmani/agent-skills/aeac41d4d005999432bb7312f7ff06383a91d59d/skills/deprecation-and-migration/SKILL.md

    Supports: bestFor, review

  5. https://raw.githubusercontent.com/addyosmani/agent-skills/aeac41d4d005999432bb7312f7ff06383a91d59d/README.md

    Supports: review

Evidence & Ask