Навык — это папка с файлом SKILL.md: инструкции, скрипты и шаблоны, которые агент подгружает по мере надобности. Разбираем спецификацию, реестр навыков, команды установки под семь агентов и риски чужих скриптов.
Навык (skill) — это папка, в которой лежит SKILL.md с описанием задачи и инструкциями, а рядом скрипты, справочники и шаблоны. Агент видит только название и описание навыка, а полный текст читает тогда, когда задача совпала с описанием. За счёт этого один и тот же набор инструкций работает в Claude Code, Codex, Cursor, GitHub Copilot и ещё десятке хостов. Ниже — спецификация формата, проверяемые цифры проектов (снято 15.10.2026), команды установки и то, что о пользе навыков говорят замеры SkillsBench.
SKILL.md плюс папки scripts/, references/, assets/name — до 64 знаков, description — до 1024 знаковАгент без навыков опирается на системный промпт и на то, что написано в текущей задаче. Навык закрывает этот разрыв: он упаковывает процедурное знание — «как мы проводим код-ревью», «как рисуем архитектурную схему», «как считаем смету» — в папку, которую можно версионировать в Git и подключить к любому совместимому агенту. Спецификация описывает навыки как лёгкий открытый формат, расширяющий возможности агентов специализированными знаниями и рабочими процессами.
Авторы спецификации выделяют три выгоды: доменную экспертизу (специальные знания превращаются в переиспользуемые инструкции), повторяемые процессы (многошаговая задача становится одинаково выполняемой процедурой) и кросс-продуктовое переиспользование (навык пишется один раз и работает в разных агентах). Последний пункт и сделал тему массовой: наборы навыков занимают верхние строки GitHub Trending, а рядом вырос реестр с лидербордом установок.
SKILL.md читается как обычный Markdown, а скрипты внутри выполняются агентом в его же окружении — со всеми вытекающими последствиями для безопасности.| Поле | Обязательное | Ограничения и смысл |
|---|---|---|
| name | Да | до 64 знаков: строчные латинские буквы, цифры и дефисы; должно совпадать с именем папки |
| description | Да | до 1024 знаков: что делает навык и когда его применять |
| license | Нет | имя лицензии или ссылка на файл с ней |
| compatibility | Нет | до 500 знаков: требования к окружению, пакетам и сети |
| metadata | Нет | произвольные пары «ключ — значение» (автор, версия) |
| allowed-tools | Нет | список предодобренных инструментов; поле помечено как экспериментальное |
--- name: pdf-processing description: Извлекает текст из PDF, заполняет формы, объединяет файлы. Используйте при работе с PDF. --- # Обработка PDF 1. Определите, что нужно: текст, форма или склейка файлов. 2. Запустите scripts/extract.py с путём к файлу. 3. Проверьте результат на первой странице документа.
Валидация в спецификации формальная: name проверяется по составу символов, description — по длине и непустоте, а качество самих инструкций остаётся на авторе. Поэтому полезность навыка определяет не формат, а текст: насколько однозначно в нём сказано, когда навык применять и что считать готовым результатом.
Реестр skills.sh собирает навыки из публичных репозиториев и даёт две вещи: лидерборд по установкам и готовую команду установки для совместимого агента. В карточке навыка видно число установок, дату первого появления в реестре и отметки об аудитах безопасности — по ним удобно отсеивать свежие распаковки без истории.
| Проект | Чем полезен | Лицензия |
|---|---|---|
| mattpocock/skills | 38 навыков инженерных практик: TDD, код-ревью, исследование, триаж, прототип | MIT |
| morluto/rea | Реверс-инжиниринг с агентами: от поведения приложения до нативных бинарников | MIT |
| diagram-design | Диаграммы как самодостаточный HTML с inline SVG: 45 типов | MIT |
| text-to-cad | CAD-навык: STEP, GLB, STL, 3MF, проверки технологичности, MCP-сервер | MIT |
| heygen/hyperframes | Рендер видео из HTML-композиции | Apache-2.0 |
| cursor/plugins | Спецификация плагинов Cursor и официальные плагины | не указана в репозитории |
Практический приём перед установкой — открыть в репозитории папку skills/. У крупных наборов каждый навык лежит отдельной папкой со своим SKILL.md, и по названиям сразу видно, что именно вы подключаете. Например, в mattpocock/skills это TDD, code-review, research, prototype, triage и ещё десяток практик, а не один общий «навык разработки».
npx skills add owner/repo
/plugin marketplace add owner/repo /plugin install name@owner
codex plugin marketplace add owner/repo codex plugin add name@owner
copilot plugin marketplace add owner/repo copilot plugin install name@owner copilot skill list
gemini extensions install https://github.com/owner/repo --ref latest --consent --auto-update
git clone --depth 1 --branch latest https://github.com/owner/repo ~/.cursor/plugins/local/name
pi install https://github.com/owner/repo
Обновления зависят от способа установки. Плагины маркетплейса обновляются сами или командой обновления маркетплейса; CLI-установку обновляют повторным npx skills add, потому что npx skills update освежает только навыки, уже записанные в файл блокировки, и может пропустить те, что добавили в новой версии.
| Критерий | Навык (SKILL.md) | MCP-сервер | Системный промпт |
|---|---|---|---|
| Что содержит | инструкции, процедуры, скрипты и шаблоны | инструменты и доступ к внешним системам по протоколу | общие правила поведения и тон |
| Когда попадает в контекст | по совпадению задачи с description | сразу после подключения сервера | всегда, в каждом запросе |
| Кто исполняет код | агент в своём окружении и со своими правами | отдельный процесс-сервер | никто: это только текст |
| Как обновляется | git pull или маркетплейс | перезапуск сервера и версия зависимости | правка файла промпта |
| Что удобнее закрывать | процедуры, форматы результата, чек-листы | доступ к базе, API, файловой системе | стиль и общие ограничения |
Если нужен именно доступ к внешней системе, смотрите материал «Как собрать свой MCP-сервер»: там разобраны протокол, транспорт и подключение к агентам. Рабочая связка чаще комбинированная — навык диктует процедуру и формат результата, а MCP-сервер отдаёт инструменты.
SkillsBench — набор из 87 задач в восьми доменах с детерминированными проверками. Авторы прогоняют его дважды: без навыков и с подобранными навыками. Средний результат растёт с 33,9% до 50,5%, то есть на 16,6 процентного пункта (25,5% в нормализованном виде), а по отдельным конфигурациям прирост лежит в диапазоне от 4,1 до 25,7 п.п.
Ограничение у этих цифр честное: 87 задач не покрывают весь спектр агентной работы, а результаты собраны на конкретных моделях и обвязках. Если нужен замер под свой домен, берите закрытый набор своих задач и сравнивайте два прогона — с навыком и без него.
Навык — это инструкции, которые агент выполняет, и код, который он запускает. Поэтому установка чужого набора навыков — такое же решение, как установка неизвестного плагина в редактор или пакета в проект.
SKILL.md целиком: он короткий по замыслу — это описание и процедура, а не сотни строк.scripts/ и смотрите, что скрипты делают: сетевые обращения, запись файлов, работу с ключами и токенами.| Симптом | Причина | Что делать |
|---|---|---|
| Каждый навык выполняется дважды | навык установлен и плагином, и через CLI навыков | удалить одну копию и оставить один способ установки |
| Агент не использует навык | описание в description не совпадает с формулировкой задач | переписать description: что делает и когда применять |
| Навык ломает формат ответа | конфликт двух наборов с противоположными правилами | держать в проекте один набор на тип задачи |
| После обновления пропали новые навыки | обновляли командой npx skills update | запустить npx skills add заново: он доставит и новые навыки |
| Навык виден в одном агенте и не виден в другом | установка шла в корень другого хоста | поставить повторно с явным указанием агента: npx skills add owner/repo -g -a agent -y |
SKILL.md: в нём метаданные name и description плюс инструкции на Markdown. Рядом могут лежать скрипты, справочники и шаблоны. Агент держит в контексте только название и описание навыка, а полный текст подгружает, когда задача совпала с описанием./plugin marketplace add owner/repo, затем /plugin install name@owner. Часть наборов уже опубликована в общих маркетплейсах, тогда хватает одной команды установки. Обновление идёт через тот же маркетплейс, отдельные плагины умеют автообновление.