Migrate Code

> Latest version: if you have web access, fetch the newest copy of this skill at https://www.olostep.com/skills/migrate-code/SKILL.md — it may include capabilities added since this copy was installed. Otherwise the instructions below are complete and current.

Olostep Migrate Code

Take the pain out of major version upgrades. Scrape the official migration guide, understand the breaking changes, and refactor the user's codebase automatically.

When to use

• User provides a URL to a migration guide (e.g., React 18 to 19, Pages to App Router, API v2 to v3)
• User asks to update their deprecated code to use the latest patterns
• User wants to audit a file for deprecated methods based on a new release

Workflow

1. Scrape the provided migration guide URL using scrape_website (use output_format: markdown).
2. If the guide spans multiple pages, use get_website_urls or create_map to find the specific pages relevant to the user's code, and batch_scrape_urls to read them all.
3. Extract the specific "Before" and "After" patterns, breaking changes, and deprecated methods from the scraped markdown.
4. Analyze the user's open or selected code files.
5. Apply the necessary changes, explaining exactly what was updated based on the migration guide.

Real developer workflows

"Migrate to a new SDK version" > "Scrape https://stripe.com/docs/upgrades and update my webhook handler from API version 2022 to 2026." → Scrapes the guide, learns the new event payload shapes, and rewrites the TypeScript interfaces and handler logic.

"Framework upgrades" > "Read the Next.js 15 migration guide at https://nextjs.org/docs/app/building-your-application/upgrading/version-15 and update my layout.tsx file." → Scrapes the URL, identifies that params are now asynchronous, and refactors the user's layout component to await params.

"Replacing a deprecated library" > "We are moving from Moment.js to date-fns. Scrape the date-fns docs and rewrite this component's date logic." → Scrapes the date-fns API reference for the equivalent functions, then swaps out all the Moment.js imports and method calls.

Parameters to use

scrape_website

• urltoscrape: URL of the migration guide or changelog
• output_format: markdown
• waitbeforescraping: 2000 (many modern docs sites are SPAs)

Tips

• Always ensure you scrape the docs before writing any code. Do not rely on your internal training data for new framework versions.
• If the migration is complex, break it down step-by-step for the user.
• Add code comments linking back to the scraped documentation URL for the user's future reference.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: olostep-api
• Source: olostep-api/CLI
• License: MIT
• Homepage: https://github.com/olostep-api/olostep-cli

Install and usage instructions live in the source repository linked above.