2026 Полное руководство по Cursor Agent Skills: формат SKILL.md, трёхуровневая загрузка и Mac cloud 7×24 на практике (с матрицей решений)

1. Три боли: зачем нужны Agent Skills

Команды, которые продуктивно используют Cursor или Claude Code, в июне 2026 сталкиваются с одними и теми же тремя узкими местами — независимо от того, делают ли они iOS-приложения, backend-сервисы или Agent Gateway вроде OpenClaw и Hermes. Первое узкое место — повторное использование: runbook деплоя, чеклисты аудита безопасности и шаблоны PR живут в Slack или личной истории чата. Каждый новичок копирует фрагменты промптов, появляются вариации, и никто не знает, какая версия «актуальна». Второе — растрата контекста: если засунуть целые гайды стиля в .cursorrules, токены тратятся при каждом старте сессии — даже когда агент читает только diff в Swift-файле. Rules подходят для постоянных принципов, но не для редких многошаговых workflow. Третье — железная реальность: идеальные Skills бесполезны, если Gateway отключается при закрытии MacBook или крутится на Linux VPS без Xcode и семантики launchd — см. нашу статью о трёхслойной памяти Hermes Agent.

1. Сложные промпты не версионируются. Чеклисты деплоя, протоколы аудита и шаблоны PR каждый раз вставляются заново; знания команды остаются в личных чатах, onboarding дорожает.
2. Контекст забивается нерелевантными правилами. Толстый .cursorrules постоянно занимает токены; при реальном кодинге агент часто не видит нужные diff файлов.
3. Skills и железо не сходятся. Skills OpenClaw или Hermes требуют Gateway 7×24; ноутбуки отключаются при закрытии крышки, дешёвые Linux VPS не имеют нативного macOS — Skills «есть», но не работают стабильно.

Коротко: Skill — это runbook для AI-агента, который загружается в нужный момент, чтобы агент делал правильное — а не всё сразу в промпте.

2. Что такое Skill? Ключевое сравнение с Rule

Начиная с Cursor 2.4, инструмент различает Rules (правила) и Skills (навыки). Rules — как employee handbook: всегда на месте, когда смена начинается. Skills — как runbook пятничного релиза: актуальны только когда кто-то говорит «деплой» или CI становится красным. Это не маркетинговая метка — она напрямую управляет расходом токенов и повторяемостью workflow.

Skills могут инкапсулировать slash-команды и shell-скрипты и работать с MCP-серверами: MCP даёт инструменты (API, БД, браузер), Skill задаёт порядок, условия остановки и точки человеческого подтверждения. Путаница между ними даёт либо слишком много Rules (медленно, дорого), либо Skills без чёткого триггера (никогда не загружаются).

3. Структура и формат файла SKILL.md

Открытый стандарт на agentskills.io намеренно минимален и переносим — тот же файл работает в Cursor, Claude Code, Codex и Gemini CLI. Структура каталога узнаваема:

Минимальный пример SKILL.md:

description — ключ маршрутизации, не резюме. Неверно: «Этот skill содержит инструкции деплоя.» Верно: чётко указать, когда загружать — триггер-слова, сценарий, опциональный glob paths. Хорошие descriptions похожи на запросы ваших разработчиков: «review PR по Conventional Commits», «staging deploy после зелёного CI», «ротация секретов перед релизом».

4. Трёхуровневая прогрессивная загрузка

Agent Skills используют трёхступенчатую модель загрузки, чтобы в репозитории могли быть сотни Skills без взрыва контекста. Шаг первый — discovery: агент видит только name и description всех зарегистрированных Skills и решает по запросу пользователя, может ли Skill быть релевантен. Шаг второй — activation: при совпадении загружается полный SKILL.md с последовательностью шагов, guardrails и ссылками на scripts. Шаг третий — on demand: файлы в references/ подтягиваются только при необходимости; scripts/ выполняются и возвращается только stdout/stderr — исходный код не потребляет body-токены.

Стандартные пути: .cursor/skills/ (проект, в Git), .agents/skills/ (альтернативный путь в некоторых CLI), ~/.cursor/skills/ (личные, на всю машину). Cursor 2.4+ предлагает /create-skill для интерактивного создания и /migrate-to-skills для миграции старых Rules и slash-команд. Проектные Skills коммитьте в Git, личные эксперименты держите в ~/.cursor/skills/, чтобы избежать drift при review.

5. Матрица решений: Skill готов — где его запускать?

Skill настолько хорош, насколько надёжна машина с его Gateway. Следующая матрица суммирует три типичных варианта для dev- и Agent-команд в июне 2026:

agentskills.io кроссплатформенный; продуктивные команды версионируют Skills в Git и принимают Gateway на Mac cloud — как в нашем развёртывании OpenClaw skill-browser. Аренда только Linux лишает notarization Xcode, Metal-инференса и plist-семантики launchd, которую предполагают большинство Agent-доков.

6. Runbook из пяти шагов: от нуля до production Skill

Шаг 1 — Определить сценарий триггера

Выберите частую задачу — например «staging deploy после зелёного CI» или «security review перед merge». Запишите реальные формулировки пользователей и опционально globs файлов в description. Мысленно проверьте: коллега сказал бы именно эти слова?

Шаг 2 — Создать SKILL.md

mkdir -p .cursor/skills/my-skill; name должен совпадать с именем каталога. Проверьте frontmatter, пронумеруйте шаги, явно укажите условия остановки.

Шаг 3 — Разделить references и scripts

Длинные тексты, compliance и примеры API — в references/; повторяемые проверки — в scripts/. В теле Skill кратко объясните, зачем нужен шаг — это помогает модели при отклонениях.

Шаг 4 — Smoke-тест

Проверьте автоматический триггер реалистичным запросом; вручную вызовите /my-skill; разберитесь с disable-model-invocation: true (Skill показывается, выполнение только по запросу пользователя).

Шаг 5 — Развернуть на Mac cloud

rsync каталога skills на узел VPSMAC; Gateway постоянно через launchd — подробности в статье узел автоматизации Agent Mac cloud.

7. Цитируемые технические факты (2026)

• Открытый стандарт: спецификация Agent Skills на agentskills.io; обязательные поля name + description; опциональные paths, disable-model-invocation, metadata.
• Встроенные команды Cursor: /create-skill интерактивно; /migrate-to-skills (2.4+) для legacy Rules и slash-команд.
• Граница безопасности: аудит сторонних Skills из ClawHub перед правами exec и сетью — чеклист в OpenClaw Production Hardening.

8. FAQ

Skill vs MCP? MCP подключает API и внешние инструменты; Skills оркестрируют многошаговые процессы. Агент станет жёстким? Нет — модель решает в рамках Skill. Куда класть? Общие Skills в ~/.cursor/skills/, проектные в .cursor/skills/ и коммитить в Git.

9. Заключение: Skill отвечает на «как», Mac cloud — на «постоянно»

Стопки промптов и перегруженные Rules тратят токены и плохо проходят review; ноутбуки отключаются, Linux VPS без Apple toolchain. Skills упаковывают процессы в версионируемые SKILL.md; аренда Mac cloud VPSMAC даёт bare-metal macOS и launchd 7×24, чтобы Gateway и Skills реально работали — а не только существовали на бумаге.