Imported from Hello-Lain/skills (
deprecation-and-migration/SKILL.md). Install upstream withnpx skills add Hello-Lain/skills --skill deprecation-and-migration. Copyright stays with the author.
Safe migration
MIT-derived workflow from addyosmani/agent-skills. Keep this entrypoint lean; preserve upstream detail in references/upstream.md.
Use
Read references/upstream.md for staged migration plans, comms, and rollback templates.
Core Rules
- Inventory consumers and compatibility constraints.
- Use expand/contract, feature flags, dual-write/read, or adapters when risk warrants.
- Classify docs before changing them: authoritative, working, historical, stale, duplicate, temporary, or redundant.
- Merge unique decisions, verification, and user-facing guidance into the authoritative location before deleting duplicate, temporary, or agent-generated docs.
- Verify references and active consumers before archiving or deleting documentation.
- Define completion metrics, rollback, and cleanup criteria.
Validation
- Run relevant repo tests/lint/build or targeted runtime checks.
- If verification cannot run, state why and give the strongest evidence collected.