Skip to content

Skills on Cursor

Cursor supports Agent Skills natively. It reads skill folders from multiple locations, so skills installed for Claude Code or OpenAI Codex are picked up automatically — no duplication required.

Cursor reads SKILL.md files from any of these directories at your project root:

  • .cursor/skills/ — Cursor-specific
  • .claude/skills/ — shared with Claude Code
  • .codex/skills/ — shared with OpenAI Codex
  • .agents/skills/ — shared convention across Cursor, OpenAI Codex CLI, Gemini CLI, and VS Code Copilot

The .agents/skills/ directory is the most portable — place skills there to share them across multiple editors from one location.

  1. Place the skill folder in .cursor/skills/ (or one of the shared directories above) at your project root.
  2. Open the project in Cursor — skills are discovered automatically.

Cursor Skills documentation (official Cursor docs)