migrate-to-skills

Migrate Cursor rules and slash commands into SKILL.md files under .cursor/skills.

Updated Apr 11, 2026

Search Tags:#automation #markdown #migration #skills #frontmatter #migrate #cursor

Ready to run

npx skills add https://github.com/fredericpoitevin/.cursor --skill migrate-to-skills-fredericpoitevin

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: migrate-to-skills
Source: https://github.com/fredericpoitevin/.cursor/tree/main/skills-cursor/migrate-to-skills
Command: npx skills add https://github.com/fredericpoitevin/.cursor --skill migrate-to-skills-fredericpoitevin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Convert Cursor rules ("Applied intelligently") and slash commands into standardized Agent Skills format by moving content into the Skills directory.

Core Features & Use Cases

Migrate project rules located under .cursor/rules/*.mdc that have a description but no globs or alwaysApply: true.
Migrate all slash commands located under .cursor/commands/*.md into individual SKILL.md entries, preserving body content verbatim.
Preserve the exact body content during migration and organize results under .cursor/skills/{skill-name}/SKILL.md.

Quick Start

Run the migration workflow to identify and convert eligible rules and commands into SKILL.md files under the skills directory, preserving the original content exactly.

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 Skills format?▼

Migrate Cursor rules to Skills format by relocating rule content from .cursor/rules/*.mdc into .cursor/skills/{skill-name}/SKILL.md, preserving the body content verbatim and adding required frontmatter. The original source files are removed after successful migration.

Can I convert Cursor slash commands into SKILL.md files?▼

Yes, you can convert Cursor slash commands from .cursor/commands/*.md or ~/.cursor/commands/*.md into individual SKILL.md files. The migration preserves the original command body content exactly and organizes results under the skills directory.

What is the difference between Cursor rules and Agent Skills?▼

Cursor rules are project-level configurations under .cursor/rules/*.mdc, while Agent Skills are standardized SKILL.md files under .cursor/skills/. Migrating rules to Skills format relocates the content and ensures required frontmatter like name and description are present.

Does the migration process delete the original Cursor rule files?▼

Yes, the migration process removes the original source files, including .mdc rules and .md slash commands, only after successfully relocating their content into the new SKILL.md files under the .cursor/skills directory.

Which Cursor rules are eligible for migration to Skills?▼

Eligible Cursor rules include those under .cursor/rules/*.mdc that have a description but no globs or alwaysApply set to true. All slash commands under .cursor/commands/*.md are also eligible for migration.

What frontmatter is required when migrating to SKILL.md?▼

Migrating to SKILL.md requires frontmatter with name and description fields. The migration process ensures these frontmatter requirements are satisfied while preserving the original rule or command body content verbatim.