Руководство по Agent Skills 2026: установка и какие навыки ставить в Claude Code и Codex

К сентябрю 2026 Claude Code, Codex, Cursor и линейка открытых coding-агентов делят один открытый формат: каталог плюс SKILL.md. Навык — это не ещё один маркетплейс плагинов. Это процедура, которая грузится по требованию. Команды по-прежнему вставляют чеклисты релиза, шаги ревью и формулы отката в CLAUDE.md или AGENTS.md либо ставят одним кликом десятки community-пакетов с GitHub. Покупательский вопрос не в том, сколько навыков у вас есть. Вопрос в том, должна ли эта процедура входить в контекст на каждом ходе, сработает ли description на чужой задаче и будут ли scripts/ в папке крутиться с теми же правами, что и вы. Эта статья не пересказывает весь открытый стандарт. Она отвечает на установку и шорт-лист: какие навыки нести в Claude Code и Codex, как их ставить и как принимать.

Почему запихивать процедуры в глобальный промпт — уже неверное решение 2026

Старый и новый путь сталкиваются предметно. Старый путь — prompt-first: всё более длинное руководство в корне репозитория, которое целиком впрыскивается в каждую сессию. Новый путь — skill-first: стабильные факты остаются в CLAUDE.md или AGENTS.md; повторяемая многошаговая работа становится SKILL.md. Агент начинает с имени и описания и грузит тело только когда пользуется навыком. Одна и та же просьба — «выкати этот релиз» — на старом пути считает вам руководство на каждом ходе, на новом — только на задаче релиза. Кто это игнорирует, продолжает платить за текст, который в этой сессии никому не нужен.

Три вещи сделали это задачей планирования, а не хобби. Во-первых, Claude Code слил пользовательские слэш-команды в Skills. Файл в .claude/commands/deploy.md и навык в .claude/skills/deploy/SKILL.md оба становятся /deploy. Старые файлы команд продолжают работать. Новые возможности — сопроводительные файлы, автовызов, субагенты — живут на каталоге навыка. Во-вторых, Codex сканирует .agents/skills от рабочего каталога вверх до корня репозитория. Личные навыки лежат в ~/.agents/skills. Старый путь ~/.codex/skills по-прежнему сканируется, поэтому навык, который «установился» в чужое дерево, выглядит как отсутствующий. В-третьих, CLI npx skills от Vercel умеет писать один и тот же пакет в Claude Code, Codex, Cursor и десятки других агентов. Переносимость держится только если вы не писали навык под закрытый frontmatter одного вендора. Команда, которая не фиксирует эти три пункта, на следующей неделе снова спорит, почему «у меня работает».

Один слой легко пропустить. Skills — это не MCP и не Function Calling. Протоколы инструментов решают, как модель вызывает живой интерфейс. Навык решает, когда загружается человеческая процедура. Как должна быть устроена tool-петля — в Что такое Function Calling. Динамическое состояние между сессиями не принадлежит телу навыка; это задача слоя памяти, разобранная в свой Agent Memory vs SaaS. Какую обвязку вы кладёте вокруг модели — отдельный покупательский вопрос в Pi vs Claude Code vs Codex. Смешивать эти слои — покупать одно и то же трижды и не чинить ни одну из трёх проблем.

Как классифицировать Agent Skills

Выстраивать имена навыков как равноправных гарантирует раздутый список избранного. Классифицируйте их по тому, кто сопровождает, когда они грузятся и есть ли побочные эффекты. Выкиньте один класс — останется только репутация. Класс говорит о счёте, риске и переделке больше, чем любой скриншот магазина.

Бандл-навыки Claude Code — это оркестровка промптов, не фиксированные бинарники: /code-review, /debug, /run, /verify, /run-skill-generator, /doctor. С v2.1.145 последние три умеют вывести запуск из README или package.json. На проекте, которому нужна база, env-файл или многошаговая сборка, один раз прогоните /run-skill-generator и закоммитьте команды установки, переменные окружения и скрипт запуска как навык внутри репозитория, чтобы следующие сессии перестали заново открывать рецепт. Codex бандлит гайды вроде skill-installer, skill-creator, review-agent и openai-docs. Обе стороны используют progressive disclosure: сначала имя и описание, тело — при использовании. Поле description — не украшение. Слишком короткое — навык не сработает. Слишком широкое — сработает на каждой мелочи. Писать описание как маркетинговую строку значит на годы купить ложные срабатывания.

Ядро сравнения: вход, исполнение, контекст, аудитория

Настоящая разница — во входе, а не в том, какая лаборатория выпустила больший каталог навыков. Держите один набор колонок, иначе решать нельзя. Те же пять заголовков держат сравнение честным и не дают таблице стать рекламным списком.

Вторая таблица закрывает только ловушки «я думал, оно установилось». Заголовки те же, чтобы проза не скатилась в пустые прилагательные. Читайте строки как бухгалтерию, не как оценку вкуса.

# Claude Code — project skill (this repo only)
mkdir -p .claude/skills/review-change

# Codex — project skill (open .agents/ convention)
mkdir -p .agents/skills/review-change

# Personal skill, every repo on this machine
mkdir -p ~/.claude/skills/review-change
mkdir -p ~/.agents/skills/review-change

# Cross-agent package manager (Vercel skills CLI)
npx skills add vercel-labs/agent-skills --skill react-best-practices -a claude-code
npx skills add vercel-labs/agent-skills --skill react-best-practices -a codex

# Codex bundled installer (often writes ~/.codex/skills)
# Inside a Codex session:
# $skill-installer linear

Минимальному SKILL.md нужны только открытые поля name и description. Файл ниже достаточен, чтобы проверить триггер и загрузку тела. Не добавляйте scripts/, пока эта петля не стала скучной. Коммитить скрипты до теста триггера — измерять сначала ущерб, а не пользу.

---
name: review-change
description: Reviews an uncommitted diff and lists risks. Use when the user asks what changed, wants a commit message, or asks to review the working tree. Do not use for greenfield feature design.
---

## Current changes

Run git diff HEAD and summarize in three bullets.
Flag missing tests, hardcoded secrets, and edits outside the named module.
If the diff is empty, say so and stop.

Какие навыки Claude Code и Codex стоит нести на самом деле

Рекомендованный стек — не топ-десять магазина вендора. Это лестница побочных эффектов. Оставляйте бандл-навыки. Оставляйте только те проектные процессы, которые повторяете каждую неделю. Кросс-репо правила оставляйте только после того, как кто-то прочитал тело. Объём без аудита — не преимущество, а более длинный список триггеров.

Сольному разработчику стоит посадить навык review-change и навык release, прежде чем решать, что нужны правила React. Небольшой продуктовой команде стоит закодировать «проверки, которые обязаны пробежать до PR» как проектный навык и оставить личный вкус в пользовательском CLAUDE.md. Клиентские пути не принадлежат пользовательскому навыку. Предприятию стоит считать навыки кодом: проводить SKILL.md и scripts/ через pull request и отказывать тем, кто симлинкует неаудированные пакеты в ~/.agents/skills. Считать это «оверхедом процесса» — открыть оверхед после первой неаудированной записи на диск.

Как выбирать по сцене

Сцена решает раньше бренда. Сначала запишите, какой процесс повторяется каждую неделю, какой CLI уже оплачен и какие права навык может иметь без спроса. Только потом выбирайте класс. Таблица ниже — правило маршрутизации, не рейтинг.

Рекомендованные связки

A — Сольный разработчик, один основной CLI: бандл-навыки оставьте включёнными. Закоммитьте только два проектных навыка: ревью незакоммиченного diff и релиз существующим скриптом. В описание напишите, когда пользоваться и когда нет. Запись файлов и bash — в контейнер или на удалённый Mac, который изолирует рабочее место на сессию. Положите расход API и аренду узла на один лист; месячная цена узла — на ценах Mac mini. Кто считает токены и аренду порознь, почти всегда занижает месяц.

B — Небольшая продуктовая команда, Claude Code и Codex вместе: ставьте пакеты правил вроде react-best-practices или web-design-guidelines по агенту через npx skills. Не сваливайте весь каталог. Релиз и откат держите в проектном дереве и ревьюйте в PR. Личные формулировки оставьте в пользовательском промпте, не в навыке. Принимайте оба CLI на одной и той же учебной задаче релиза. Не считайте, что навык, сработавший в одной обвязке, сработает в другой. Команда, которая один раз измерила оба пути, меньше спорит про «у меня работает».

C — Предприятие или высокая безопасность: считайте навыки кодом. Каталог, скрипты и описание идут через pull request. Запретите неаудированные пакеты в пользовательских папках. Скрипты, которые открывают сеть или трогают секреты, крутятся только на одноразовом узле. Границы аккаунта и поставки — в справочном центре. Когда нужно изолированное рабочее место, начинайте с аренды Mac mini, а не превращайте офисный ноутбук в лабораторию. Аудиту нужны воспроизводимые узлы, а не агент с теми же правами, что Slack и браузер.

Частые ловушки

1. Покупать по избранному: «больше навыков — умнее агент». Каждое широкое описание — бюджет ложных срабатываний. Список избранного — не критерий шорт-листа.
2. Оставлять процедуры в глобальном промпте: чеклист релиза, который грузится каждую сессию, — это руководство, за которое вы платите на каждом ходе. Текст не бесплатен только потому, что уже лежит в репозитории.
3. Считать пути универсальными: .claude/skills у Claude Code — не корень по умолчанию для Codex. Установщик Codex всё ещё может писать в ~/.codex/skills. Пропавший вызов чаще всего значит чужое дерево, а не отсутствующую функцию.
4. Ставить на пользовательский уровень, не прочитав скрипты: scripts/ наследуют запустившего пользователя. Сначала каталог проекта, сначала изолированный узел. Непрочитанный пакет в ~/.claude/skills протечёт во все репозитории на машине.
5. Подменять тесты community-навыком: /verify и ваш CI — не заменители. Навык не заменяет красно-зелёную сюиту. Считать навык тестом — измерять прозу, а не поведение.

План действий: 7 шагов

1. Откройте CLAUDE.md или AGENTS.md. Пометьте каждую процедуру длиннее абзаца как кандидата: релиз, ревью, откат, changelog. Факты оставьте. Шаги вынесите. То, что короче абзаца, часто остаётся фактом, не навыком.
2. Напишите один SKILL.md без scripts/. В описание положите, когда пользоваться и когда нет. Вызовите его один раз через /review-change или $review-change. Без этого ручного доказательства автотриггер — только надежда.
3. Спросите обычным языком и посмотрите, сработает ли сам. Если сработал на чужой задаче — перепишите описание. Не ставьте второй навык, чтобы закрыть первый. Второе широкое описание удваивает бюджет ложных срабатываний.
4. Кладите навыки Claude Code в .claude/skills/, навыки Codex — в .agents/skills/. Если тот же пакет должен видеть Cursor или другой агент, используйте npx skills add … -a, а не копируйте чужую папку руками. Перепутанное дерево выглядит как мертворождённый навык.
5. Остановитесь на бандле плюс два–четыре проектных навыка. Community-пакет входит в проектное дерево только после того, как кто-то прочитал SKILL.md и скрипты. Он не входит сначала в ~/.claude/skills или ~/.agents/skills. Пользовательская папка — исключение, не значение по умолчанию.
6. Навыки со scripts/ гоняйте в контейнере или на удалённом Mac. Секреты держите вне промпта и вне тела навыка. Рабочее место должно стираться в конце сессии. Изоляция — часть приёмки, не послемыслие после утечки.
7. Принимайте на одной задаче релиза или ревью: сработал ли, какие файлы затронул, зелёны ли исходные CI-тесты. Тёплый локальный кэш, который «выглядит зелёным», — не приёмка. Воспроизводимость бьёт разовую зелёную демо.

FAQ

Чем Skills отличаются от CLAUDE.md или AGENTS.md?

Стабильные факты — в CLAUDE.md или AGENTS.md, их читают каждую сессию. Повторяемые многошаговые процедуры — в Skills, тело грузится только при использовании. Чеклист релиза в глобальном промпте значит: вы платите за инструкцию на каждом ходе. Разница в моменте загрузки, не в расширении файла.

Могут ли Claude Code и Codex делить один навык?

Они делят открытый формат SKILL.md. Они не делят пути и вызов. Claude Code читает .claude/skills/ и ~/.claude/skills/. Codex читает .agents/skills/ и ~/.agents/skills/ и всё ещё сканирует старый путь ~/.codex/skills. Целитесь в агента через npx skills -a. Кто проверяет только одну сторону, часто объявляет мёртвым уже установленный навык.

Ставить ли одним кликом все популярные GitHub-навыки?

Нет. Широкое описание срабатывает не на тех задачах. scripts/ идут с теми же правами, что и вы. Прочитайте SKILL.md и любые скрипты, затем ставьте в каталог проекта — не в пользовательскую папку, которая протечёт во все репозитории. Пакет «десятки одним кликом» — список избранного, не шорт-лист.

Чем Codex $skill-installer отличается от npx skills?

$skill-installer — бандл-установщик Codex и часто пишет в ~/.codex/skills. npx skills — кросс-агентный пакетный менеджер и может целиться в claude-code или codex. Рукописные навыки кладите в .agents/skills или .claude/skills. Проверьте оба дерева, прежде чем решить, что «не установилось». Типичная ошибка — читать только то дерево, в которое писали сами.

Можно ли гонять навыки со скриптами на повседневном ноутбуке?

Запустятся. Не делайте этого на незнакомом репозитории или продовых секретах. Сначала контейнер или удалённый Mac-узел, подтвердите область триггера и записи, затем решите, готов ли навык к командному репозиторию. Ноутбук, где почта, Slack и агент делят одни права, — не лаборатория, а общая поверхность атаки.

Вывод

В 2026 не превращайте community-рейтинг в корзину для Agent Skills. Сначала выбирайте по классу входа: бандл-навыки как запасной путь вендора, проектные навыки для релиза и ревью, которые повторяете каждую неделю, и кросс-репо правила только после того, как кто-то их прочитал. Claude Code и Codex делят формат. Они не делят каталог по умолчанию. Держите описания узкими, ставьте скрипты поздно и считайте пользовательскую папку исключением, а не значением по умолчанию. Запишите разделение, триггер, путь и стираемый узел в семишаговую приёмку. Удалённые узлы начинаются на странице аренды и странице цен. Вопросы по аккаунту — в справочный центр. Кто держит этот порядок, покупает меньше ложных срабатываний и больше повторяемых релизов.

Читать дальше

• Pi vs Claude Code vs Codex: как выбрать обвязку 2026 →
• Что такое Function Calling: OpenAI, Gemini, Claude →
• Свой Agent Memory vs SaaS Memory →