# Migration

> Migration is an Agent Skill for development published in the fedify-dev/fedify repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Help the user migrate Fedify code between versions. Use when the user needs to upgrade their Fedify version, fix breaking-change errors, or update deprecated API usage.

- Skill name: `migration`
- Category: [Development](https://www.openparable.com/skill/development/1)
- Source: https://github.com/fedify-dev/fedify/blob/HEAD/claude-plugin/skills/migration/SKILL.md
- Repository: fedify-dev/fedify (1,012 GitHub stars when collected)

## SKILL.md

Help the user migrate Fedify code from “$ARGUMENTS”.


Migration workflow
------------------

1.  Fetch *CHANGES.md* from the repo to identify breaking changes between
    the versions in question:
    `https://raw.githubusercontent.com/fedify-dev/fedify/main/CHANGES.md`
2.  List every breaking change that affects the user's code range.
3.  For each breaking change, show the old API, the new API, and a concrete
    before/after code snippet.
4.  Search the user's codebase for usages of deprecated symbols and suggest
    the replacement.
5.  Note any dependency changes (e.g., vocabulary moved to `@fedify/vocab`,
    runtime to `@fedify/vocab-runtime`).


Key migration hints
-------------------

 -  `@fedify/fedify/vocab` → `@fedify/vocab` (dedicated package)
 -  `@fedify/fedify/runtime` → `@fedify/vocab-runtime`
 -  In-tree *src/webfinger* → `@fedify/webfinger`
 -  *src/x/* exports removed in 2.0.0

---

Source: https://www.openparable.com/skill/development/migration (OpenParable). Cite the canonical URL above.
