cursor-upgrade-migration

Upgrade Cursor versions and migrate settings. Triggers on "upgrade cursor","update cursor", "cursor migration", "cursor new version", "cursor changelog".

⭐878stars🔀101forks📁View on GitHub🕐Updated Jan 4, 2026

When & Why to Use This Skill

This Claude skill streamlines the process of upgrading the Cursor IDE and migrating user configurations. It provides a comprehensive framework for version checking, settings backup, and troubleshooting, ensuring developers can transition to new versions without losing custom extensions, keybindings, or AI-powered features. By automating the migration workflow, it minimizes downtime and maintains environment consistency.

Use Cases

  • 1. Seamless IDE Upgrades: Safely update Cursor to the latest version while preserving custom editor configurations and ensuring AI features remain functional.
  • 2. Environment Migration: Efficiently transfer settings, extensions, and preferences between different workstations or during a fresh system installation.
  • 3. Version Management & Troubleshooting: Access release notes and changelogs directly to identify breaking changes and resolve post-upgrade issues using structured error-handling guides.
name"cursor-upgrade-migration"
description|
allowed-tools"Read, Write, Edit, Bash(cmd:*)"
version1.0.0
licenseMIT
author"Jeremy Longshore <jeremy@intentsolutions.io>"

Cursor Upgrade Migration

Overview

This skill provides comprehensive guidance for upgrading Cursor IDE versions and migrating settings between installations. It covers version checking, upgrade methods, settings backup, and troubleshooting common migration issues.

Prerequisites

  • Current Cursor installation to upgrade
  • Backup of current settings (recommended)
  • Admin rights for installation (if required)
  • Network access for download

Instructions

  1. Check current version (Help > About)
  2. Backup settings and extensions list
  3. Check release notes for breaking changes
  4. Apply update (auto-update or manual download)
  5. Verify settings preserved
  6. Test AI features working
  7. Reinstall extensions if needed

Output

  • Updated Cursor installation
  • Preserved settings and configurations
  • Verified working AI features
  • Documented changes and fixes

Error Handling

See {baseDir}/references/errors.md for comprehensive error handling.

Examples

See {baseDir}/references/examples.md for detailed examples.

Resources