projectb-migrate-to-skills

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

Updated May 28, 2023
One-click install
npx skills add https://github.com/steveulrich/ProjectB --skill projectb-migrate-to-skills-steveulrich
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: projectb-migrate-to-skills
Source: https://github.com/steveulrich/ProjectB/tree/main/.agents/skills/projectb-migrate-to-skills
Command: npx skills add https://github.com/steveulrich/ProjectB --skill projectb-migrate-to-skills-steveulrich

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams that accumulated Codex rules (.cursor/rules/.mdc) and slash commands (.cursor/commands/.md) need a consistent way to consolidate them into the Agent Skills format without losing or altering the original instruction content. ## Core Features & Use Cases - Rule Migration: Converts .mdc rule files with a description (and no globs or alwaysApply) into SKILL.md files with name and description frontmatter while preserving the body verbatim. - Command Migration: Converts plain markdown slash commands into SKILL.md files, adding name, inferred description, and disable-model-invocation frontmatter. - Parallel Subagent Workflow: Dispatches subagents to find, convert, and clean up files across project and user-level .cursor directories, with an undo path to restore originals. - Use Case: A repository with dozens of .cursor/rules/*.mdc files can be migrated in one pass into .cursor/skills/ directories, each containing a valid SKILL.md, with originals deleted only after conversion. ## Quick Start Migrate all of my Cursor rules and slash commands in this workspace into Agent Skills under .cursor/skills/.

Frequently Asked Questions about projectb-migrate-to-skills

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

FAQPage Schema
How do I convert .mdc rules to SKILL.md format?▼

Read the .mdc file, extract its description and body, then create .cursor/skills/{name}/SKILL.md with name and description frontmatter plus the exact original body. Remove globs and alwaysApply fields, and delete the original rule file after verifying the migration.

How to migrate Cursor slash commands into Agent Skills?▼

Convert each .cursor/commands/*.md file by adding frontmatter with a name from the filename, a description inferred from the first heading, and disable-model-invocation: true. Keep the original markdown body character-for-character in the new SKILL.md.

Which Cursor rules should be migrated to skills?▼

Migrate only rules that have a description but no globs and no alwaysApply: true, since these are the 'applied intelligently' rules. Rules with glob patterns or always-on application should remain as rules.

Can I undo a rules-to-skills migration?▼

Yes, the migration is reversible. Ask the assistant to undo the migration and it will restore the original .mdc rule files and .md command files by reversing the conversion steps.

Why does the migrated command skill include disable-model-invocation?▼

Slash commands are designed to be explicitly triggered by the user through the / menu, not automatically suggested by the model. The disable-model-invocation: true field preserves that explicit-trigger behavior after conversion.