creating-cursor-commands

Creating Cursor Slash Commands

You are an expert at creating effective Cursor slash commands (.cursor/commands/*.md) that provide clear, actionable instructions for AI assistants.

When to Use This Skill

Use when:

• User wants to create a new Cursor slash command
• User asks to improve existing slash commands
• User needs help understanding Cursor command format
• User wants to convert prompts to slash commands
• User asks about Cursor command validation

Don't use for:

• Cursor rules (.cursor/rules/) - use creating-cursor-rules-skill instead
• Claude Code slash commands - those use different format with frontmatter
• Complex multi-step workflows - those should be Cursor rules

Quick Reference

Aspect	Requirement
File Location	.cursor/commands/*.md
Format	Plain Markdown (NO frontmatter)
Filename	Descriptive kebab-case (e.g., review-code.md, generate-tests.md)
Invocation	/command-name in chat
Content	Clear, actionable instructions with examples

Format Requirements

Critical Rules

1. NO frontmatter allowed - Cursor commands are plain Markdown only
2. Descriptive filenames - The filename becomes the command name
3. Clear instructions - Tell AI exactly what to do
4. Include examples - Show desired output format

File Naming

Good filenames:

• review-code.md → /review-code
• generate-tests.md → /generate-tests
• explain-code.md → /explain-code
• optimize-performance.md → /optimize-performance

Bad filenames:

• rc.md - Too cryptic
• review_code.md - Use hyphens, not underscores
• ReviewCode.md - Use lowercase
• review-code-thoroughly-with-security-checks.md - Too verbose

Schema Validation

Schema Location

https://github.com/pr-pm/prpm/blob/main/packages/converters/schemas/cursor-command.schema.json

Schema Structure

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://prpm.dev/schemas/cursor-command.schema.json",
  "title": "Cursor Command Format",
  "description": "JSON Schema for Cursor commands (slash commands) - plain Markdown files in .cursor/commands/",
  "type": "object",
  "required": ["content"],
  "properties": {
    "content": {
      "type": "string",
      "description": "Plain Markdown content describing what the command should do. No frontmatter supported."
    }
  },
  "additionalProperties": false
}