migrate-to-skills Skill
将“Applied intelligently” Cursor 规则(.cursor/rules/*.mdc)和斜杠命令(.cursor/commands/*.md)转换为 Agent Skills 格式(.cursor/skills/)。当用户想把规则或命令迁移为 skills、将 .mdc 规则转换为 SKILL.md 格式,或把命令整合到 skills 目录时使用。
安装方式:把技能目录放入 ~/.claude/skills/(Claude Code)或在 claude.ai 设置中启用;也可复制右侧安装命令一键添加。
技能指令原文(SKILL.md)
Migrate Rules and Slash Commands to Skills
Convert Cursor rules ("Applied intelligently") and slash commands to Agent Skills format.
Copy each body verbatim — byte for byte, whitespace and typos included. The content is the user's, and an exact copy is what makes the migration reversible.
Locations
| Level | Source | Destination |
|-------|--------|-------------|
| Project | {workspaceFolder}/*/.cursor/rules/.mdc, {workspaceFolder}/.cursor/commands/*.md |
| User | ~/.cursor/commands/*.md |
Notes:
- Cursor rules inside the project can live in nested directories; glob
*/.cursor/rules/.mdcfrom the workspace root so none are missed. - Ignore anything in ~/.cursor/worktrees
- Ignore anything in ~/.cursor/skills-cursor. This is reserved for Cursor's internal built-in skills and is managed automatically by the system.
Finding Files to Migrate
Rules: Migrate if rule has a description but NO globs and NO alwaysApply: true.
Commands: Migrate all - they're plain markdown without frontmatter.
Conversion Format
Rules: .mdc → SKILL.md
# Before: .cursor/rules/my-rule.mdc
---
description: What this rule does
globs:
alwaysApply: false
---
# Title
Body content...
# After: .cursor/skills/my-rule/SKILL.md
---
name: my-rule
description: What this rule does
---
# Title
Body content...
Changes: Add name field, remove globs/alwaysApply, keep body exactly.
Commands: .md → SKILL.md
# Before: .cursor/commands/commit.md
# Commit current work
Instructions here...
# After: .cursor/skills/commit/SKILL.md
---
name: commit
description: Commit current work with standardized message format
disable-model-invocation: true
---
# Commit current work
Instructions here...
Changes: Add frontmatter with name (from filename), description (infer from content), and disable-model-invocation: true, keep body exactly.
Note: disable-model-invocation: true keeps the model from invoking the skill on its own and keeps its description out of the always-on skill roster that every request pays for. Slash commands are user-triggered from the / menu, so migrated commands carry it.
Notes
namemust be lowercase with hyphens onlydescriptionis critical for skill discovery- The workflow below deletes originals after the skill file is written; the user can ask to undo, which restores them
Migrate a Rule (.mdc → SKILL.md)
- Read the rule file
- Extract the
descriptionfrom the frontmatter - Extract the body content (everything after the closing
---of the frontmatter) - Create the skill directory:
.cursor/skills/{skill-name}/(skill name = filename without .mdc) - Write
SKILL.mdwith new frontmatter (nameanddescription) + the EXACT original body content (preserve all whitespace, formatting, code blocks verbatim) - Delete the original rule file
Migrate a Command (.md → SKILL.md)
- Read the command file
- Extract description from the first heading (remove
#prefix) - Create the skill directory:
.cursor/skills/{skill-name}/(skill name = filename without .md) - Write
SKILL.mdwith new frontmatter (name,description, anddisable-model-invocation: true) + blank line + the EXACT original file content (preserve all whitespace, formatting, code blocks verbatim) - Delete the original command file
Workflow
Use the read, edit, and delete tools for these files rather than the terminal: they preserve bytes exactly and keep every change undoable.
If you have the Task tool available, delegate the file work so the main context stays free of file contents. Dispatch three general-purpose subagents in parallel (not Explore — it is read-only), one each for project rules ({workspaceFolder}//.cursor/rules/.mdc), user commands (~/.cursor/commands/.md), and project commands ({workspaceFolder}//.cursor/commands/*.md). The work is mechanical; low effort is enough. Each subagent:
I. [ ] Finds files to migrate in its pattern
II. [ ] For rules, keeps only "applied intelligently" rules (has description, no globs, no alwaysApply: true). Commands are always migrated.
III. [ ] Lists the files to migrate. If empty, done.
IV. [ ] For each file, reads it, then writes the new skill file with the body verbatim.
V. [ ] Deletes the original file.
VI. [ ] Returns the migrated skill paths with their original paths.
- [ ] Create the skills directories if they don't exist (
.cursor/skills/for project,~/.cursor/skills/for user) - [ ] Dispatch the subagents and wait for all of them
- [ ] Summarize the results and tell the user they can ask you to undo the migration
- [ ] If asked to undo, reverse the steps to restore the original files
If you don't have the Task tool available, do step 1, then I–V yourself across both project (.cursor/) and user (~/.cursor/) directories, then steps 3–4.