Contributing

1. Create a Kit

Use the CLI to scaffold an empty kit structure:

npx cursorkits init command-kit my-workflow
cd my-workflow

This creates a directory with the required files and a kit.json manifest.

2. Write Your Content

• Commands — write clear step-by-step instructions in command.md
• Skills — document domain knowledge, patterns, and conventions in SKILL.md
• Agents — define the agent's persona, capabilities, and workflow in agent.md
• Rules — write .mdc files with glob patterns and coding conventions
• Hooks — create shell scripts that receive JSON on stdin and output JSON responses

3. Validate

npx cursorkits validate

Checks that your kit.json is valid, required files exist, and naming conventions are followed.

4. Publish

Sign in at cursorkits.com and use the publish page to upload your kit. Your kit will be available to all users immediately after publishing.

Best Practices

• Write clear, actionable instructions — avoid vague guidance
• Include tags so users can discover your kit
• Test your kit in a fresh project before publishing
• Use descriptive names that indicate purpose
• Keep descriptions under 200 characters
• List dependencies if your kit requires other kits
• Version your kit with semver when making updates