sync-rules-and-skills

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.