skills.rest
kkkaoru
kkkaoruCOMMUNITY
Explore all skills by this author →
𝕏@kkk4oruGitHub

migrate-to-skills

Convert Cursor rules and slash commands into Agent Skills SKILL.md format.

Updated Oct 15, 2019
Search Tags:#migration#agent skills#slash commands#frontmatter#rules#skill.md#cursor
One-click install
npx skills add https://github.com/kkkaoru/dotfiles --skill migrate-to-skills-kkkaoru
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: migrate-to-skills
Source: https://github.com/kkkaoru/dotfiles/tree/main/.cursor/skills-cursor/migrate-to-skills
Command: npx skills add https://github.com/kkkaoru/dotfiles --skill migrate-to-skills-kkkaoru

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Cursor projects accumulate 'Applied intelligently' rules (.cursor/rules/.mdc) and slash commands (.cursor/commands/.md) that need to be consolidated into the newer Agent Skills format (.cursor/skills/). Manually converting each file while preserving its exact body content is tedious and error-prone. ## Core Features & Use Cases - Rule Migration: Converts .mdc rules that have a description but no globs or alwaysApply flag into SKILL.md files with name and description frontmatter. - Command Migration: Converts plain markdown slash commands into SKILL.md files, adding name, inferred description, and disable-model-invocation: true so they remain user-triggered. - Verbatim Preservation: Copies body content character-for-character without reformatting, and optionally deletes originals after verification. - Use Case: After upgrading a project to the Agent Skills layout, run this migration to move all eligible rules and commands from .cursor/rules and .cursor/commands into .cursor/skills/ in one pass, with subagent-parallel processing when the Task tool is available. ## Quick Start Ask the assistant to migrate all eligible Cursor rules and slash commands in this workspace to the skills directory.

Frequently Asked Questions about migrate-to-skills

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate Cursor rules to Agent Skills format?▼

Rules with a description but no globs and no alwaysApply: true are converted by creating .cursor/skills/{name}/SKILL.md with name and description frontmatter, copying the body verbatim, and deleting the original .mdc file.

How do I convert Cursor slash commands to skills?▼

Each .md command file becomes .cursor/skills/{name}/SKILL.md with frontmatter containing name from the filename, a description inferred from the first heading, and disable-model-invocation: true so it stays user-triggered via the slash menu.

Which Cursor rules are eligible for skill migration?▼

Only 'Applied intelligently' rules qualify: those with a description field but no globs and no alwaysApply: true. Rules with globs or alwaysApply stay as rules, and anything under ~/.cursor/worktrees or ~/.cursor/skills-cursor is ignored.

Can I undo a Cursor rules to skills migration?▼

Yes. Ask the assistant to undo the migration and it reverses the process, restoring the original .mdc rule files and .md command files from the generated SKILL.md files.

Does the migration change the content of my rules or commands?▼

No. The body content is copied character-for-character with all whitespace, formatting, and code blocks preserved. Only the frontmatter is added or adjusted; nothing is reformatted or rewritten.

Related Skills

Explore More Software Engineering Skills→
shoshoavishoshoavi

migrate-to-skills

Convert Cursor rules and slash commands into Agent Skills format.

Community
Intermediate
brujackbrujack
5

migrate-to-skills

Convert Cursor .mdc rules and .md commands into SKILL.md files.

Community
Intermediate
mappa-aimappa-ai
1

write-a-skill

Create SKILL.md files with frontmatter and optional references or scripts.

Official
Intermediate
amhuppertamhuppert
2

cursor-rules

Create and edit Cursor rules files with MDC frontmatter and globs.

Community
Intermediate