This repository serves as a centralized location for storing and managing Cursor rules (.mdc files) and their documentation (.md files). The structure mirrors the .cursor/rules hierarchy to make it easy for users to copy rules directly into their Cursor projects.
Each rule-set folder follows the same structure:
rule-set-name/
├── *.mdc # The rule files (written in plain English)
└── README.md # Documentation for the rule-set
- Use kebab-case for rule-set names (e.g.,
workshop-writer) - Folder names should be descriptive of the rule-set's purpose
- Each rule-set should be in its own folder
- Each rule-set folder must contain a
README.md - Documentation should include:
- Rule-set purpose and functionality
- Usage instructions
- Examples
- Any dependencies or prerequisites
.mdc- Cursor rule files (written in plain English).md- Documentation files.gitignore- Git ignore configuration
When adding new rule-sets:
-
Create a new folder for your rule-set:
mkdir your-rule-set-name
-
Add your files:
- Add your
.mdcrule files (written in plain English) - Create
README.mdwith documentation for the rule-set
- Add your
-
Follow the naming conventions:
- Use kebab-case for folder names
- Keep names descriptive and concise
-
Ensure your rule-set follows the
.cursor/ruleshierarchy structure for easy integration
To use these rules in your Cursor project:
- Copy the desired rule-set folder to your project's
.cursor/rules/directory - The rules will be automatically loaded by Cursor
- Follow the rule-set's README.md for specific configuration instructions