Как установить skill в Cursor: полное руководство

Как установить skill в Cursor: полное руководство

Cursor — AI-редактор кода который поддерживает «rules» — текстовые инструкции, которые задают AI контекст о проекте и задачах. Skills с AgentPoint экспортируются именно в этот формат. Разберём как это работает, куда что класть и почему старый способ больше не работает.

---

Два формата: .cursorrules (устаревший) и .mdc (актуальный)

В интернете много инструкций про файл .cursorrules в корне проекта. Важно знать: этот формат не работает в Agent mode — Cursor молча его игнорирует. Если вы используете агентные workflow (а в 2025 году это основной режим работы), .cursorrules бесполезен.

Актуальный формат — файлы .mdc в папке .cursor/rules/.

---

Структура .mdc файла

Каждый .mdc файл — это один skill или набор инструкций. Файл начинается с frontmatter (метаданные в формате YAML между тройными дефисами), после которого идёт текст инструкций.

---
description: Когда применять этот rule — одна фраза
globs:
  - "src/**/*.ts"
  - "*.tsx"
alwaysApply: false
---

Текст инструкций для AI.
Pиши здесь что угодно — обычный текст, markdown, примеры кода.

Параметры frontmatter

description — одна фраза объясняющая зачем этот rule. Cursor использует её когда решает нужно ли подключать rule автоматически (режим Agent Requested). Пишите чётко: «Инструкции по написанию ответов на отзывы маркетплейса» лучше чем «Мой rule».

globs — паттерны файлов. Rule автоматически подключается когда в контексте открыты файлы по этим паттернам. Примеры:

• "src/**/*.ts" — все TypeScript файлы в папке src
• "*.md" — все markdown файлы
• "components/**" — всё в папке components

Если skill не привязан к типам файлов (например, skill для написания текстов) — оставьте globs пустым или не указывайте.

alwaysApply — true или false. Если true — rule загружается в каждый запрос независимо от контекста.

---

Четыре режима активации

Always Apply (alwaysApply: true)

Rule подключается к каждому запросу в Cursor. Используйте только для самых важных и коротких правил — например, соглашение о коде или язык ответов.

Предупреждение: каждое слово в rule занимает токены контекста. При большом количестве Always-rules они конкурируют между собой и могут вытеснить важный контекст проекта. Держите Always-rules до 200 слов.

Auto Attached (через globs)

Rule автоматически подключается когда в контексте открыты подходящие файлы. Это оптимальный режим для большинства skills — rule работает когда нужен, не занимает место когда не нужен.

Пример: skill для работы с компонентами React подключается автоматически когда открыт .tsx файл.

Agent Requested (через description)

Cursor сам решает подключать ли rule, основываясь на description и задаче в текущем запросе. Не нужны ни globs ни alwaysApply — нужна чёткая description.

Пример: skill «Написание ответов на отзывы клиентов» — Cursor подключит его когда пользователь спросит про отзывы.

Manual (вызов через @)

Rule не подключается автоматически. Вы вызываете его явно написав @название-rule в запросе.

Пример: @skill-review-response Напиши ответ на этот отзыв: [текст]

Подходит для специализированных skills которые нужны редко и в конкретных ситуациях.

---

Установка skill из AgentPoint: пошагово

Шаг 1: Скачайте экспорт

На странице skill нажмите «Экспорт» и выберите формат Cursor. Вы получите файл с расширением .mdc.

Шаг 2: Создайте папку если её нет

В корне вашего проекта создайте папку .cursor/rules/ если она ещё не существует.

mkdir -p .cursor/rules

Шаг 3: Положите файл в папку

Скопируйте .mdc файл в .cursor/rules/. Имя файла — любое, главное расширение .mdc.

ваш-проект/
├── .cursor/
│   └── rules/
│       ├── skill-review-response.mdc
│       └── skill-product-description.mdc
├── src/
└── ...

Шаг 4: Проверьте в Cursor

Откройте Cursor → Settings (⌘,) → Rules. Вы должны видеть ваш rule в списке. Если rule не появился — проверьте что файл именно в .cursor/rules/, а не просто в .cursor/.

Шаг 5: Протестируйте

Откройте новый чат в Cursor. Для Auto Attached rules — откройте файл который соответствует glob-паттерну. Напишите тестовый запрос в рамках задачи skill.

Для Manual rules — напишите @имя-файла (без расширения .mdc) в чате.

---

Подключение MCP к Cursor

Некоторые skills используют внешние tools через MCP — например, для чтения данных из CRM или обращения к API.

Настройка MCP в Cursor:

1. Откройте файл .cursor/mcp.json (создайте если нет)
2. Добавьте конфигурацию сервера:

{
  "mcpServers": {
    "название-сервера": {
      "command": "npx",
      "args": ["-y", "@название/mcp-пакет"],
      "env": {
        "API_KEY": "ваш-ключ"
      }
    }
  }
}

1. Перезапустите Cursor
2. В Agent mode у вас теперь доступны tools из MCP-сервера

Инструкции для конкретных MCP-серверов (Bitrix24, WB, Ozon) — в MCP Directory на AgentPoint.

---

Типичные ошибки

Rule не появляется в списке

Проверьте:

• Файл находится в .cursor/rules/, а не в .cursor/ или корне проекта
• Расширение файла именно .mdc, не .md и не .txt
• Frontmatter написан правильно (три дефиса --- в начале и в конце)

Rule есть, но AI его не использует

Проверьте режим активации:

• Для alwaysApply: true — должен работать в любом запросе
• Для globs — откройте файл который соответствует паттерну
• Для Agent Requested — улучшите description, сделайте её точнее
• Для Manual — вы вызываете его через @?

AI игнорирует инструкции из rule

Возможные причины:

• Слишком много rules с alwaysApply: true — они конкурируют, часть игнорируется
• Rule слишком длинный — сократите до сути, уберите лишние объяснения
• Инструкции противоречат друг другу — проверьте что rules не конфликтуют
• Запрос пользователя перекрывает rule — попробуйте сослаться на rule явно: «используй инструкции из [название rule]»

Старый .cursorrules не работает в Agent

Перенесите содержимое .cursorrules в файл .cursor/rules/main.mdc и добавьте frontmatter с alwaysApply: true. После этого rule начнёт работать в Agent mode.

---

Советы по организации rules

Один skill — один файл. Не складывайте всё в один большой rule. Отдельный файл для ответов на отзывы, отдельный для карточек товаров, отдельный для стиля кода.

Называйте файлы понятно. skill-review-response.mdc лучше чем rule1.mdc. Особенно для Manual режима — вы будете писать @skill-review-response в чате.

Держите Always-rules короткими. Если rule нужен всегда — он должен быть компактным. Длинные правила лучше делать Auto Attached или Agent Requested.

Секреты — в .env, не в rules. Если skill требует ключей API или токенов — передавайте их через переменные окружения, а в rule пишите только название переменной (process.env.API_KEY). Файлы rules могут попасть в git-репозиторий.

Добавьте .cursor/rules/ в .gitignore если нужно. Если rules содержат конфиденциальные инструкции — исключите папку из системы контроля версий. Если хотите шарить rules с командой — наоборот, добавьте в репозиторий.