Поиск «Claude Skills» ведёт в документацию Anthropic, «Agent Skills» — на agentskills.io, в Cursor — «Rules». Все три названия содержат Skill или Rule, и многие думают: «это одно и то же, просто в другой папке». На деле три слоя: Cursor Rules — постоянные правила IDE, Claude Skills — runbook по запросу в Claude Code, Agent Skills — открытый формат SKILL.md для разных инструментов. Статья разбирает термины через единые таблицы, матрицу сценариев и копируемые примеры. Несимметричный вывод: водораздел — «постоянные ограничения vs runbook по запросу vs соглашение о формате», а не «какая модель сильнее».
Для разработчиков, которые используют Cursor и Claude Code. Определения, пути, момент загрузки, переносимость и типичные ошибки. Наш материал Workflow / Rules / Skills — трёхслойная инженерия — про архитектуру; этот текст — словарь трёх хайповых терминов. Официально: Cursor Rules, Claude Code Skills, Agent Skills Specification.
1. Почему Claude Skills, Agent Skills и Cursor Rules смешивают
С конца 2025 по 2026 год AI-инструменты для кода одновременно продвигали «версионируемые конфигурации агента»: Cursor с .cursor/rules и .cursor/skills, Anthropic с .claude/skills в Claude Code, сообщество — agentskills.io как кросс-хостовый стандарт. Маркетинг везде повторяет Skill и Agent — типичная путаница:
- 30-шаговый релизный чеклист в Cursor Rules, тысячи токенов в каждом чате;
- В Claude Code ищут панель «Rules», а продукт называет это Skills;
- Чужой
SKILL.md— класть в.cursorили.claude? - «Agent Skills» принимают за новый SaaS, хотя это спецификация файлов.
Причина — наложение продуктового, реализационного и стандартного слоёв в именовании. Если вы читали AI Coding Workflow, Rules, Skills — полное руководство, держите его как архитектуру; здесь — таблица соответствий и справочник решений.
Одиночные разработчики пишут всё в AGENTS.md; команды не могут ревьюить границу Rules и Skills. Таблицы ниже дают общий язык в PR: «это Rule или Skill?»
2. Что означает каждый термин (What)
2.1 Cursor Rules — слой постоянно загружаемых ограничений
Cursor Rules — постоянная политика Cursor: при открытии подходящего проекта автоматически попадает в контекст. Типичные места: .cursor/rules/*.mdc, пользовательские Rules в настройках, AGENTS.md в корне. Подходит для минимального diff, запрещённых каталогов, языка ответа, обязательных тестов, запрета force push — коротко, жёстко, в каждом разговоре. Документация настаивает: длинные runbook сюда не писать.
2.2 Claude Skills — runbook по запросу в Claude Code
Claude Skills (Claude Code Skills) — пакеты возможностей в терминальном/IDE-агенте Anthropic: .claude/skills/<name>/SKILL.md (также на уровне пользователя). Агент сначала читает description во frontmatter, при совпадении намерения загружает тело и выполняет многошаговые сценарии — review, релиз, security audit. Явный вызов /skill-name; disable-model-invocation предотвращает ложные срабатывания. Углубление: руководство Claude Code Skills — фреймворк из 10 пунктов.
2.3 Agent Skills — открытый стандарт SKILL.md между инструментами
Agent Skills — не переключатель вендора, а Agent Skills Specification: frontmatter SKILL.md (name, description и т.д.), текст runbook, опциональные references/ и скрипты. Cursor, Claude Code и другие хосты парсят по одной конвенции — команда может синхронизировать одно тело Skill в .cursor/skills и .claude/skills, подправив frontmatter. Стандарт решает переносимость, но не заменяет постоянные Cursor Rules.
3. Сравнительная таблица (How Compare)
| Тип | Вход | Исполнение | Контекст | Аудитория |
|---|---|---|---|---|
| Cursor Rules | Открытие проекта / glob | Ограничить правки, формат, запретные зоны | Постоянно, держать кратко | Все пользователи Cursor, ревьюеры |
| Claude Skills | /skill или семантическое совпадение description |
Многошаговые runbook (review, релиз) | По запросу, возможны references/ | Пользователи Claude Code / API Agent |
| Agent Skills | Реализация хоста (не отдельный продукт) | Структура и метаданные SKILL.md | Не занимает контекст до загрузки | Кросс-туловые команды, мейнтейнеры OSS |
3.1 Пути и зона ответственности
| Критерий | Cursor Rules Продукт Cursor | Claude Skills / Agent Skills Слой runbook |
|---|---|---|
| Типичный путь | .cursor/rules/*.mdc | SKILL.md в .claude/skills/ или .cursor/skills/ |
| Стандарт | Документация Cursor | Спека Agent Skills + доки хоста |
| Копирование между IDE | Только Cursor (идею можно переписать вручную) | Тело общее, пути зависят от хоста |
| Подходящий контент | Красные линии, стиль, права | Чеклисты, последовательности команд, шаблоны |
4. Матрица решений по сценарию
| Ваш сценарий | Приоритет | Примечание |
|---|---|---|
| Только Cursor для бизнес-кода | 3–5 Rules проекта → при необходимости Cursor Skills (формат Agent Skills) | Runbook не в Rules; review/миграция — в Skill |
| Только терминальный агент Claude Code | Claude Skills (формат Agent Skills) → CLAUDE.md для ограничений | Нет панели Cursor Rules; ограничения в файлах проекта |
| Двойной стек Cursor + Claude Code | Общее тело SKILL.md → .cursor/skills и .claude/skills → Rules отдельно |
Agent Skills = формат; Cursor Rules = ограничения Cursor |
| Гайд для OSS-контрибьюторов | CONTRIBUTING + пакет Agent Skills (security-review) → опциональные фрагменты Rules | Skill полезен и без Cursor |
| Runbook с Xcode / codesign | Skill с последовательностью команд → Rules запрещают менять signing → узел macOS | С сборкой macOS в GitHub Actions; компиляция на удалённом Mac |
5. Рекомендуемые стеки
Стек A — только Cursor (личный проект)
- Rules:
core.mdcс тремя красными линиями (минимальный diff, commit только по запросу, lint после правок) - Skills: один
code-review(формат Agent Skills в.cursor/skills/) - Без каталога
.claude— меньше шума в репозитории
Стек B — только Claude Code (терминал в приоритете)
- Claude Skills:
commit,security-reviewсdisable-model-invocation: true CLAUDE.mdв корне = постоянные ограничения (аналог Rules, не Agent Skill)
Стек C — команда с двойным стеком (рекомендуется)
- Исходный каталог
skills/или submodule; CI в.cursor/skillsи.claude/skills - Cursor Rules — для разработчиков на Cursor; пользователи Claude читают
CLAUDE.md - Новые Skills сначала по Agent Skills, затем тонкая настройка под инструмент
Стек D — агент с удалённым исполнением
- Skill описывает SSH на облачный Mac и
xcodebuild - Rules запрещают prod без подтверждения
- Фиксированный macOS-раннер — см. «среду исполнения» в сравнении AI-инструментов для кода
6. Типичные заблуждения
«Agent Skills — эксклюзив Claude»→ открытый формат; Claude Skills — реализация Anthropic.«20 шагов релиза в Cursor Rules»→ в Skill; длинные Rules тратят контекст каждого чата.«Скопировать SKILL.md в rules/ — достаточно»→ другое расширение и загрузчик;.mdcне матчит description Skill.«Нужно выбрать одно»→ типично: Rules + Skills + формат Agent Skills.«Skills заменяют Rules»→ Skills по запросу; «никогда force push» требует постоянных Rules.«Обновление стандарта = автосовместимость Claude»→ следить за agentskills.io и changelog хостов.
7. Семь шагов внедрения — с примерами
- Инвентаризация: что действует в каждом чате → кандидаты в Rules; редкие процессы → Skills.
- Написать Rules: < 80 строк на файл,
globsдля области. - SKILL.md по Agent Skills:
name+descriptionс глагола. - Каталог хоста: Cursor
.cursor/skills/<name>/SKILL.md; Claude.claude/skills/. - Рискованные Skills:
disable-model-invocation: true, только явный вызов. - Git: версионировать вместе с кодом в одном PR.
- Узел macOS: в runbook указать SSH-цель и проверки при Xcode/shell.
# .cursor/rules/core.mdc --- description: Core repo constraints (always on) globs: "**/*" --- - Minimize diff; no drive-by refactors. - Never commit unless the user explicitly asks. - Do not modify backend/ unless the task requires it.
# .cursor/skills/code-review/SKILL.md (Claude: .claude/skills/code-review/SKILL.md) --- name: code-review description: Review staged git diff for bugs and test gaps. Use when user asks for review or before PR. --- 1. Run `git diff --staged` (or branch vs main). 2. Report Critical / Warning / Suggestion. 3. Do not auto-fix unless asked.
--- name: xcode-release description: Archive and export IPA on macOS runner. Manual invocation only. disable-model-invocation: true --- Prerequisites: macOS host, valid signing cert, Xcode selected. Steps: clean → archive → export → verify IPA checksum.
8. Итог
Cursor Rules задают линию, которую нельзя пересекать в каждом чате Cursor; Claude Skills — как выполнять класс задач в Claude Code; Agent Skills — как выглядит файл SOP и как его переносить между хостами. Это не взаимоисключение, а слой ограничений + продуктовая возможность + стандарт формата. Сначала разложите по слоям, потом копируйте чужие конфиги — так реже бывает «файл лежит, но не срабатывает».
Дополнительно: Cursor Rules · Claude Code Skills · Agent Skills · Workflow / Rules / Skills
FAQ
Rules и Skills требуют согласованной среды исполнения
Сборки Xcode, Fastlane или шаги launchd из SKILL.md требуют нативный macOS. Hashvps Cloud Mac mini M4 — SSH/VNC, выделенный IPv4, воспроизводимый Homebrew: одни и те же Skills ведут себя локально и в облаке одинаково.
Если вы подключаете Claude Skills или Cursor Skills к iOS-релизу, облачный Mac Hashvps — экономичный узел исполнения — смотреть тарифы и гонять runbook удалённо 7×24.