skills.rest
nthpaul
nthpaulCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

migrate-to-skills

Migrate Cursor rules and slash commands into Agent Skills SKILL.md files.

Updated May 18, 2025
Search Tags:#automation#markdown#migration#agent skills#symlinks#cursor#workspace config
One-click install
npx skills add https://github.com/nthpaul/dotfiles --skill migrate-to-skills-nthpaul
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: migrate-to-skills
Source: https://github.com/nthpaul/dotfiles/tree/main/cursor/.cursor/skills-cursor/migrate-to-skills
Command: npx skills add https://github.com/nthpaul/dotfiles --skill migrate-to-skills-nthpaul

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of manually converting Cursor “Applied intelligently” rules and slash commands into the Agent Skills format so your workflows can live in one consistent skills directory.

Core Features & Use Cases

  • Migrates project and user Cursor files: Converts {workspaceFolder}/**/.cursor/rules/*.mdc and {workspaceFolder}/.cursor/commands/*.md plus ~/.cursor/commands/*.md.
  • Converts rules with the right criteria: Only migrates rules that have a description and do not include globs and are not marked with alwaysApply: true.
  • Consolidates commands into skills: Migrates slash command markdown files into .cursor/skills/<skill-name>/SKILL.md for consistent invocation.
  • Preserves instruction content exactly: Keeps the original body character-for-character to avoid accidental changes.

Quick Start

Ask the Skill to convert your Cursor rules and slash commands to Agent Skills format across both project and user locations, then summarize what was migrated.

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 and slash commands to Agent Skills format?▼

To migrate Cursor rules and slash commands, the Skill extracts descriptions and headings, then creates `.cursor/skills/<name>/SKILL.md` files with proper frontmatter while preserving original body content exactly.

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

Cursor rules are `.mdc` files under `.cursor/rules` using criteria like `alwaysApply` or `globs`, while Agent Skills consolidate workflows into `.cursor/skills/<name>/SKILL.md` files for consistent invocation.

Which Cursor rules can be converted into skills?▼

Only Cursor rules with a `description` and without `globs` or `alwaysApply: true` can be converted. Rules lacking descriptions or using global apply settings are skipped during migration.

Does the Cursor skills migration preserve original instruction content?▼

Yes, the migration preserves original body content character-for-character. It extracts metadata for frontmatter but keeps instructional text exactly as written in the source files.

Can I migrate slash commands from both project and user `.cursor` locations?▼

Yes, you can migrate slash commands from both workspace and user `~/.cursor/commands/*.md` locations. The tool skips internal `skills-cursor` directories during conversion.

What happens to original Cursor files after migrating to skills?▼

After successful migration, original Cursor rule and command files can be optionally deleted. This prevents duplication while ensuring workflows live consistently in the skills directory.

Related Skills

Explore More Software Engineering Skills→
edheltzeledheltzel
134

converting-slash-commands

Convert Claude Code slash commands to OpenCode command format.

Community
Advanced
PandelisZPandelisZ
1

migrate-to-skills

Convert Cursor rules and slash commands into Agent Skills format.

Community
Intermediate
cslsoftwarescslsoftwares

governance-pack-checklist-validation

Validate .cursor pack mirror symlinks and references for structural integrity.

Community
Advanced
abhimehroabhimehro
2

migrate-to-skills

Convert Cursor rules and slash commands into SKILL.md entries.

Community
Advanced