migrate-to-skills

Convert Cursor .mdc rules and .md commands to SKILL.md format.

Updated Jan 17, 2026
One-click install
npx skills add https://github.com/teaglebuilt/aiconfig --skill migrate-to-skills-teaglebuilt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: migrate-to-skills
Source: https://github.com/teaglebuilt/aiconfig/tree/main/.cursor/skills-cursor/migrate-to-skills
Command: npx skills add https://github.com/teaglebuilt/aiconfig --skill migrate-to-skills-teaglebuilt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the migration of existing Cursor rules and slash commands into the new Agent Skills format, streamlining the transition to a more organized and discoverable skill management system.

Core Features & Use Cases

  • Rule Conversion: Transforms .mdc rule files into SKILL.md format, preserving descriptions and body content while adapting frontmatter.
  • Command Conversion: Converts .md slash command files into SKILL.md format, inferring descriptions and adding necessary metadata like disable-model-invocation.
  • Use Case: You have a collection of custom rules and commands in your Cursor project that you want to consolidate and manage as part of a unified skills framework. This Skill handles the bulk conversion process efficiently.

Quick Start

Use the migrate-to-skills skill to convert all .mdc rules and .md commands in the project to the new SKILL.md format.

Frequently Asked Questions about migrate-to-skills

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

FAQPage Schema
How do I convert Cursor rules and slash commands to SKILL.md format?

You can convert Cursor rules and slash commands by migrating .mdc and .md files into the Agent Skills SKILL.md format. This process transforms frontmatter, preserves body content, infers descriptions, and sets invocation flags for project-level and user-level configurations.

What is the best way to migrate .mdc rule files to a unified skills framework?

Migrating .mdc rule files to a unified skills framework involves transforming them into SKILL.md format. This conversion adapts the frontmatter while preserving the original descriptions and body content, streamlining the transition to a more organized management system.

Does migrating slash commands to SKILL.md format preserve the existing content?

Yes, migrating slash commands to SKILL.md format preserves existing content. It converts .md command files by inferring descriptions, adding necessary metadata like disable-model-invocation flags, and applying precise content preservation during the frontmatter transformation.

Can I bulk convert project-level and user-level Cursor configurations simultaneously?

Yes, you can bulk convert project-level and user-level Cursor configurations simultaneously. The migration applies to configurations within the .cursor directory, handling both rules and commands efficiently to consolidate them into a unified skills framework.

Why does converting slash commands require inferring descriptions and setting invocation flags?

Converting slash commands requires inferring descriptions and setting invocation flags because .md command files lack certain metadata. Adding flags like disable-model-invocation and inferring descriptions ensures the new SKILL.md format maintains proper discoverability and function.

What are the limitations of migrating Cursor rules to the Agent Skills format?

The primary limitation of migrating Cursor rules to the Agent Skills format is that it strictly targets .mdc and .md files within the .cursor directory. Files outside this structure or in unsupported formats require manual adjustment before the automated conversion can process them.