cursor-sdk — скилл для Claude Code: агенты Cursor из кода
Скилл для тех, кто запускает агентов Cursor из TypeScript: подсказывает схему вызова, рантайм и разбор ошибок.
npx skills add cursor/plugins --skill cursor-sdk -a claude-codeЧто делает cursor-sdk
Скилл включается, когда вы пишете приложение, скрипт или шаг CI поверх @cursor/sdk. Пакет запускает агентов Cursor из кода, без IDE. Локальный рантайм работает с файлами на вашей машине, облачный берёт клонированный репозиторий и открывает пул-реквест.
Внутри SKILL.md и папка references/: выбор между локальным и облачным запуском, авторизация, обработка CursorAgentError и ретраев, стриминг событий, настройка MCP-серверов, субагенты и Agent.resume. Отдельный файл отведён готовым паттернам вроде бота для ревью PR или разбора по расписанию.
Три схемы вызова идут сразу с кодом: Agent.prompt для одноразового запроса, Agent.create вместе с agent.send для диалога и стрима, Agent.resume для продолжения старого агента. Ключ CURSOR_API_KEY нужен до первого вызова, иначе придёт 401 — на этом чаще всего и спотыкаются.
Какие задачи решает
- Запустить агента Cursor из CI-пайплайна, не открывая IDE
- Выбрать локальный или облачный рантайм под конкретную задачу
- Разобрать 401 и правильно передать
CURSOR_API_KEY - Отличить
Agent.promptотAgent.createс последующимиagent.send - Подключить MCP-сервер к агенту, запущенному из скрипта
Примеры запросов агенту
- Напиши на
@cursor/sdkскрипт, который черезAgent.promptрефакторитsrc/utils.tsи печатает статус. - Собери шаг GitHub Action:
Agent.create, стрим событий в лог, потом follow-up на регрессионный тест. - Хочу продолжить агента с id из прошлого запуска — покажи вызов
Agent.resume.
Как установить cursor-sdk
1Через Skills CLI (Vercel)
npx skills add cursor/plugins --skill cursor-sdk -a claude-code2Вручную: положить файлы
~/.claude/skills/cursor-sdk/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/cursor-sdk/
1Через Skills CLI (Vercel)
npx skills add cursor/plugins --skill cursor-sdk -a codex2Вручную: положить файлы
.agents/skills/cursor-sdk/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add cursor/plugins --skill cursor-sdk -a cursor2Вручную: положить файлы
.cursor/skills/cursor-sdk/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install cursor/plugins cursor-sdk2Вручную: положить файлы
.github/skills/cursor-sdk/SKILL.md1Через Skills CLI (Vercel)
npx skills add cursor/plugins --skill cursor-sdk -a gemini-cli2Командой платформы
gemini skills install https://github.com/cursor/plugins --path cursor-sdk/skills/cursor-sdkВручную: положить файлы
.devin/skills/cursor-sdk/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add cursor/plugins --skill cursor-sdk -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о cursor-sdk
Как установить cursor-sdk в Claude Code?
Выполните npx skills add cursor/plugins --skill cursor-sdk -a claude-code. Файл скилла окажется по пути ~/.claude/skills/cursor-sdk/SKILL.md.
Что делает cursor-sdk?
Помогает писать интеграции на @cursor/sdk: подсказывает форму вызова, объясняет разницу локального и облачного запуска, разбирает ошибки и стриминг.
Что нужно, чтобы агент вообще запустился?
Ключ CURSOR_API_KEY в окружении и выбранная модель, например composer-2. Без ключа запрос вернёт 401, остальное уже детали схемы вызова.
