agent-skills-setup
AI Context Migration Tool Across IDEs/Agents
Install & Use
Copy this prompt and send it to your AI assistant (Claude / Cursor / TRAE / Codex / WorkBuddy etc.) to auto-install:
Help me install this AI Skill: agent-skills-setup. It is used for: AI Context Migration Tool Across IDEs/Agents Full Skill content: https://321skill.com/skills/agent-skills-setup-x-7/raw/index.md Read that page and install it.
The prompt includes a link to the full Skill content. You can also view the full content.
This Skill addresses the issues of manual copying—such as errors, omissions, or compatibility problems—when migrating skills, rules, prompts, commands, and MCP configurations across multiple IDEs (e.g., Cursor, Claude, Windsurf) or different AI Agents. In real-world development, when teams switch toolchains or upgrade environments, there is often a need to migrate a mature set of custom instructions and model context to a new platform. However, file paths, schemas, and authentication mechanisms vary across platforms, making manual migration highly risky.
Usage is straightforward: simply describe your migration intent in an AI conversation, such as "Migrate Cursor's rules and MCP configuration to a Claude Desktop project." It will automatically parse the source and target platforms, read the corresponding IDE reference documentation, preview the scope of changes via --dry-run mode, and execute the actual migration after confirmation. The entire process includes path resolution, object selection, boundary checks, strategy generation, and finally, validation scripts to ensure the migration results are correct.
It is ideal for developers who frequently switch development environments or need to unify their team's AI toolchain. This is especially true for individuals or teams maintaining custom skills and MCP configurations across multiple platforms like Cursor, Claude, and Windsurf, as well as for agent developers needing to migrate project context from an old IDE to a new one.
It is recommended to use --dry-run first to confirm the impact scope before migrating, to avoid directly overwriting target configurations. Note that it primarily handles file-based objects (skills, rules, prompts, commands, MCP server files) and is not applicable to UI-managed MCP configurations (e.g., Claude Desktop's Settings→Extensions). Sensitive data such as secrets, session tokens, and chat history are not migrated and must be recreated manually.
Key Features
Unlike manual copy-paste or custom scripts, it features built-in path mapping and schema validation for multiple IDEs, automatically identifying compatibility conflicts and rejecting migrations. It also supports `--dry-run` previews and `--json` evidence output, with automatic post-migration validation—whereas typical scripts often perform only simple file copies.
Limitations
Only supports Linux/macOS environments, relies on bash and the smart-ide-migration.sh script, and does not support Windows natively. It cannot read or write UI-managed MCP configurations in Claude Desktop (Settings→Extensions), which must be recreated manually.
FAQ
Can it migrate from Cursor to Claude?
Yes, it supports source as cursor and target as claude, as well as other mainstream IDEs/Agents like windsurf and iflycode.
Does it support migrating MCP servers?
Yes, but only for file-based MCP configurations (e.g., mcp.json); it does not apply to UI-managed MCP in Claude Desktop.
Installation guide for AI assistants
If your AI coding assistant (Claude Code, Cursor, TRAE etc.) can see this page, send it this message to auto-install:
Visit https://321skill.com/skills/agent-skills-setup-x-7/raw/index.md to read the original Skill definition (Markdown format) for agent-skills-setup, and install it according to the instructions.
Raw Markdown URL for AI: /skills/agent-skills-setup-x-7/raw/index.md