2026 AGENT
SKILLS_
METAL_
MAC.
На Mac с Cursor вы снова вручную проталкиваете один и тот же runbook — staging, тесты, PR? Статические промпты и always-on Rules жрут контекст и не переносятся между репо. Agent Skills упаковывают операционное знание в папку с SKILL.md и подгружают его по релевантности задачи. Открытый стандарт agentskills.io (конец 2025) уже в Cursor, Claude Code, Gemini CLI и 16+ инструментах. Это hardcore-руководство 2026 для Mac: Skill vs Rule, трёхуровневая progressive disclosure, layout, /create-skill, граница MCP, Metal/MLX и удалённый Mac 7×24. Вывод: процедуры — в Skills, не в Rules; description = триггеры; репо — .cursor/skills/, кросс-репо — ~/.cursor/skills/; тяжёлые scripts/ — на Metal-узел с запасом по unified memory.
1. Узкие места по цифрам: зачем Skills в 2026
Четыре паттерна, которые режут throughput Mac-команд на Cursor. ① Промпты не масштабируются — ~800 токенов deploy-текста на чат, шаги теряются при сжатии истории. ② Rules платят фиксированную цену контекста — стиль и security floor — да; 12 КБ release-runbook на каждый символ автодополнения — нет. ③ Фрагментация стеков — только .cursorrules не спасёт; для Claude Code/Gemini CLI — .agents/skills/. ④ MCP ≠ Skill — MCP даёт API; Skill задаёт порядок вызовов и критерии «зелёного» состояния между ними.
На начало 2026 индексы показывают 31 000+ публичных Skills; marketplace Cursor — Rules + Skills + MCP одним кликом. Progressive disclosure снижает средний burn: Level 1 ~100 токенов/Skill (только discovery), Level 2 — полный SKILL.md (цель <5000 токенов), Level 3 — stdout скриптов без заливки исходников в окно.
На MacBook с параллельными Xcode, FCP, ComfyUI и локальным MLX каждый КБ Rule в hottest layer — это unified memory, которую вы не отдаёте под diff или падающий тест. Skills не добавляют GFLOPS, но убирают операционную простыню из контекста во время правки одной строки CSS.
2. Skill vs Rule: матрица владения
| Измерение | Rule | Skill |
|---|---|---|
| Загрузка | Вся сессия | При совпадении задачи |
| Лучше для | Стиль, naming, security floor | Deploy, PR, audit, runbooks |
| Стоимость контекста | Фикс на turn | Progressive disclosure, ниже в среднем |
| Аналогия | Онбординг | Операторский мануал |
| Путь на Mac | .cursor/rules/ | .cursor/skills/ или ~/.cursor/skills/ |
Cursor 2.4+: /migrate-to-skills для раздутых dynamic Rules; после миграции Rules ~<2 КБ, нумерованные шаги — в Skills с исполняемыми scripts/.
3. Layout и контракт SKILL.md
Skill = директория. Обязателен SKILL.md (YAML + Markdown). Опционально scripts/, references/, assets/:
Frontmatter — description описывает когда активировать, не «что внутри папки»:
Тело SKILL.md — процедура, ветки отказа, verify-команды; тома API — в references/, чтобы Level 2 не раздувал окно.
4. Трёхуровневая progressive disclosure
Level 1 — Discovery: только name + description. Level 2 — Activation: полный SKILL.md (<500 строк). Level 3 — Execution: references/, scripts/, в контекст — stdout/stderr, не мегабайтные логи сборки. Триггеры: авто, ручной (/skill-name), attach (@skill-name). Production и ротация ключей — только ручной триггер.
Антипаттерн: пихать Level-3 в description — ломает экономику Level 1 и даёт ложные срабатывания. Второй антипаттерн: скрипт без summary вывода — режьте через JSON/exit-code, как описано в Skill.
5. Discovery paths на macOS
| Путь | Scope | Типично |
|---|---|---|
.cursor/skills/ | Репозиторий | Deploy, domain schema |
~/.cursor/skills/ | Глобально user | Commit, test, PR |
.agents/skills/ | Cross-tool проект | Общие runbooks |
~/.agents/skills/ | Cross-tool global | Стандарты команды |
После добавления папок — Settings → Rules: Skill в списке discovery, затем интеграционный промпт с перефразировкой.
6. Пять шагов: первый Skill
Шаг 1 — /create-skill
В Agent-чате опишите поток словами: stage → commit → push → PR через gh.
Шаг 2 — name = имя папки
lowercase, цифры, дефисы, max 64; несовпадение ломает discovery.
Шаг 3 — description = триггеры
❌ «Содержит инструкции deploy» → ✅ «deploy, release, staging, production, pipeline».
Шаг 4 — логика в scripts/
Bash/Python с явными exit codes; на macOS — chmod +x, в SSH-обёртках абсолютные пути.
Шаг 5 — приёмка на реальной задаче
Парафраз, не копипаст description; при толстых legacy Rules — сначала /migrate-to-skills.
7. Экосистема 2026 и матрица Metal/Mac
| Способность | Инкапсуляция | Заметка Mac |
|---|---|---|
| Стиль / security floor | Rule | коротко, always-on |
| Deploy / PR / audit | Skill | scripts/ + SSH на Metal-узел |
| GitHub / DB API | MCP | Skill задаёт порядок tool calls |
| OpenClaw 7×24 | Skill + remote gateway | проверка skillsSnapshot |
| MLX / Ollama bench | references/ + scripts/ | гнать на узле с headroom по памяти |
В 2026 в топе: Vercel React Best Practices (40+ perf-правил), PR Skills с gh, TDD-Skills. OpenClaw: после /new свежий snapshot — runbook skillsSnapshot. MCP — провод; Skill — playbook с verify между вызовами.
8. Best practices (операторский срез)
• Один домен — один Skill; крупный поток — deploy + verify + rollback отдельно.
• SKILL.md <500 строк; API-тома в references/.
• Объяснять why — «validate до deploy, иначе launchd падает без env».
• Один глагол для deploy — не мешать «релиз/выкат/пуш».
• Gather → Act → Verify с наблюдаемым exit (HTTP 200, green tests, URL PR).
• Версионировать Skills в git; при смене runbook — заметка в frontmatter.
9. Кейс: /mac-quote на платформе аренды Mac GPU
«Три Skills: /mac-quote, /contract-draft, /device-check. Ценообразование в scripts/quote.py, SKILL.md ~120 строк. После миграции с Rules: среднее время обработки 18 → 6 минут, always-on Rules 12 КБ → 2 КБ — throughput поддержки ×3 без прироста IQ модели. Рычаг — процедура + детерминированные скрипты.»
Для инфраструктуры: Skill remote-mac-acceptance — SSH, порты, MLX smoke; исполнение на datacenter Mac, Cursor на ноутбуке — лёгкий оркестратор. Skill = как; remote Mac = где и с какой пропускной способностью Metal.
10. FAQ и цифры для цитирования
Q: Skill vs MCP? MCP — инструменты; Skill — процедура и verify.
Q: Skills принуждают агента? Нет — guidance, не sandbox.
Q: Версия Cursor? 2.4+ стабильно.
Цифры: ① 16+ tools на agentskills.io (2026-Q1). ② 31 000+ community Skills. ③ Кейс 18→6 min. ④ SKILL.md <5000 tokens на activation. ⑤ Discovery ~100 tokens/Skill для capacity planning.
Чеклист приёмки: description = триггеры □ | name = папка □ | scripts + failure paths □ | путь project/global □ | MCP отделён □ | paraphrase test □ | remote SSH smoke □ | MLX bench на узле с headroom □
11. Оркестрация с Windows/Linux → Mac compute node
Skills пишутся на любой ОС; Mac — path of least resistance для Xcode, FCP, ComfyUI, Metal-инференса, launchd 7×24. Cloud IDE режет код; MLX baseline, ProRes proxy farm и OpenClaw после сна ноутбука — на Apple Silicon с питанием и охлаждением. Архитектура 2026: Skills кодируют процедуру; Mac-узел кодирует ёмкость и tokens/sec на Metal. SKILL.md и discovery — там, где вы ведёте диалог с агентом; долгие scripts/ — на remote host с запасом unified memory.
Windows-команды могут валидировать OpenClaw, но multimedia и always-on gateway часто уезжают на Mac mini или арендованный MACGPU-узел. В Skill пропишите SSH: user, key, cwd, log paths успеха. Ноутбук оставляет unified memory под diff, а не под шестичасовой render или MLX sweep с троттлингом на закрытой крышке.
Нужна стабильная Apple Silicon ёмкость под scripts, gateway и regression baselines — удалённый Mac MACGPU: OpenClaw, batch, приёмка 7×24 в стойке; Cursor на столе — консоль оркестрации. Skill говорит, что такое «готово»; remote Mac доказывает это без превращения основной машины в обогреватель.