deprecation-and-migration
Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementa…
What it does
- Replacing an old system, API, or library with a new one
- Sunsetting a feature that's no longer needed
- Consolidating duplicate implementations
- Removing dead code that nobody owns but everybody depends on
- Planning the lifecycle of a new system (deprecation planning starts at design time)
- Deciding whether to maintain a legacy system or invest in migration
- Cover all critical use cases of the old system
Requirements & configuration
- Removing dead code that nobody owns but everybody depends on
- Reason: OldService requires manual scaling and lacks observability.
- Zombie code is code that nobody owns but everybody depends on. It's not actively maintained, has no clear owner, and accumulates security vulnerabilities and compatibility issues. Signs:
- | "Someone might need it later" | If it's needed later, it can be rebuilt. Keeping unused code "just in case" costs more than rebuilding. |
- | "We'll write the rollback if we need it" | A migration with no down path is a deploy you can't reverse. Write and run the down before merging. |
Configuration: UPDATECREATE
Derived from the skill's own SKILL.md documentation · extracted 2026-07-23
Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when deciding whether to maintain or sunset existing code.
Source
Repository: https://github.com/addyosmani/agent-skills
deprecation-and-migration FAQ
What does the deprecation-and-migration skill do?
Manages deprecation and migration. Use when removing old systems, APIs, or features. Use when migrating users from one implementation to another. Use when deciding whether to maintain or sunset existing code. Replacing an old system, API, or library with a new one Sunsetting a feature that's no longer needed
What does deprecation-and-migration require?
Removing dead code that nobody owns but everybody depends on Reason: OldService requires manual scaling and lacks observability. Zombie code is code that nobody owns but everybody depends on. It's not actively maintained, has no clear owner, and accumulates security vulnerabilities and compatibility issues. Signs: | "Someone might need it later" | If it's needed later, it can be rebuilt. Keeping unused code "just in case" costs more than rebuilding. | | "We'll write the rollback if we need it" | A migration with no down path is a deploy you can't reverse. Write and run the down before merging. | Configuration keys: UPDATE, CREATE.
How do I install deprecation-and-migration?
Run: npx -y skills add https://github.com/addyosmani/agent-skills --skill deprecation-and-migration --agent claude-code — the source lives at github.com/addyosmani/agent-skills.
Maintain deprecation-and-migration?
Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.
[](https://getagentictools.com/skills/addyosmani-agent-skills-deprecation-and-migration?ref=badge) npx agentictools info skills/addyosmani-agent-skills-deprecation-and-migration The second line is the CLI lookup for this page — handy in READMEs and docs.