migrate-to-skills

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/*.mdc from 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.