migrate-to-skills

To convert Cursor rules into reusable markdown skills, this tool transforms .cursor/rules/*.mdc files into SKILL.md format. It recreates the required frontmatter, copies the original body content verbatim, and removes the migrated source files.

Moving Cursor slash commands into a skills directory relocates .cursor/commands/*.md files while applying the required frontmatter. The process preserves the exact markdown body content, ensuring formatting, code blocks, and instructions remain unchanged during consolidation.

Migrating cursor rules to skills does not change your original markdown content. The process copies the body content verbatim from .mdc and .md files, ensuring formatting, code blocks, and underlying instructions remain exactly as they were before the migration.

You should consolidate nested Cursor rules into Agent Skills when you want to organize scattered rules and slash commands into reusable entries without rewriting instructions. This is ideal for refining applied intelligently rules into structured skill directories.

After migrating to skills, the original .cursor rules and command files are removed from the workspace. This deletion happens only after the exact markdown body content and frontmatter are successfully recreated within the new skill directory structure.