---
name: "Official Cursor SKILL.md format, discovery paths, and built-in /create-skill"
description: "Use when creating a Cursor SKILL.md via /create-skill with official discovery paths."
---

# Official Cursor SKILL.md format, discovery paths, and built-in /create-skill

## When
Use when a Cursor skill must live in .cursor/skills/ (or .agents/skills/) with name matching the folder.

## Stop
Never put personal ~/.cursor/skills/ and expect Cloud Agents to see them. Never skip the description router line.

## Steps
1. Use this skill when...
2. This skill is helpful for...
3. Step-by-step guidance for the agent
4. Domain-specific conventions
5. Best practices and patterns
6. Use the ask questions tool if you need to clarify requirements with the user
7. "**/*.tsx"
8. "packages/ui/**/*.ts"

## Load
/create-skill. .cursor/skills/<name>/SKILL.md.