sync-rules-and-skills

Consolidate overlapping Cursor rule and SKILL.md content into authoritative files.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/moraluco/Illusion-Cursor-dev-kit --skill sync-rules-and-skills
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sync-rules-and-skills
Source: https://github.com/moraluco/Illusion-Cursor-dev-kit/tree/main/.cursor/skills/sync-rules-and-skills
Command: npx skills add https://github.com/moraluco/Illusion-Cursor-dev-kit --skill sync-rules-and-skills

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates duplication and role confusion between Cursor Rule files and Skill documents by auditing, mapping, and consolidating overlapping content so that rules remain lightweight triggers and skills carry authoritative procedures.

Core Features & Use Cases

  • Audit and mapping: List and compare .cursor/rules/.mdc files against .cursor/skills//SKILL.md to determine overlaps and missing ownership.
  • Content migration: Migrate detailed workflows, examples, and project-specific conventions from Rule bodies into the appropriate SKILL.md pages.
  • Rule compression and guidance: Replace long Rule bodies with short trigger descriptions and explicit pointers to the authoritative Skill, preserving frontmatter and minimal context.
  • Governance output: Produce a concise changelog of modified rules and skills and recommend git commit messages and TODOs for unresolved human decisions.
  • Use case: When updating Kit conventions or adding new rules, run this Skill to ensure all content is centralized, discoverable, and non-redundant.

Quick Start

Review all .cursor/rules/.mdc and .cursor/skills//SKILL.md, identify overlaps, migrate detailed content into the appropriate SKILL.md, compress each rule body to a one-line pointer, and prepare a concise changelog for commit.

Frequently Asked Questions about sync-rules-and-skills

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

FAQPage Schema
How do I de-duplicate overlapping content between Cursor rules and skills?

To de-duplicate Cursor rules and skills, audit .cursor/rules/*.mdc files against .cursor/skills/*/SKILL.md, identify overlapping sections, and migrate detailed workflows into the authoritative SKILL.md files.

What is the difference between a Cursor rule and a Skill document?

Cursor rules should act as lightweight triggers with short descriptions and pointers, while Skill documents serve as authoritative pages carrying detailed procedural workflows, examples, and project-specific conventions.

How do I consolidate .mdc rule files into concise trigger descriptions?

Consolidate .mdc rule files by replacing long rule bodies with one-line pointers to the authoritative Skill, preserving the original frontmatter and minimal context while migrating procedural content into SKILL.md.

Can I use this rule-to-skill mapping process on any Cursor-based workspace?

Yes, you can apply this rule-to-skill mapping process to UE dev kit repositories and other Cursor-based workspaces to verify mappings, eliminate redundant documentation, and centralize project conventions.

How do I generate a changelog for modified Cursor rules and skills?

Generate a changelog for modified Cursor rules and skills by tracking all migrated content and compressed rule bodies, then producing a concise log with recommended git commit messages and unresolved TODOs.