SKILL.md: один файл, который читают все агенты

Разбор · август 2026

Пару лет назад каждый агент учили по-своему. У одного инструкции лежали в .cursorrules, у другого в системном промпте, у третьего в самодельном markdown, который надо было руками подсовывать в контекст. Переезжаешь на другой инструмент — переписываешь все заново.

Формат agent skills это закрыл. Anthropic опубликовала его открытым стандартом в конце 2025 года, и к нынешнему августу его читают Claude Code, Claude Desktop, Claude API, Codex CLI от OpenAI, Cursor, Google Antigravity и GitHub Copilot. Один и тот же файл, без переписывания под каждого.

Что это такое

Навык — это папка, внутри которой лежит как минимум один файл: SKILL.md. В начале файла YAML-заголовок с именем и описанием, дальше обычный markdown с инструкциями. Все.

my-skill/
├── SKILL.md          # заголовок + инструкции
├── scripts/          # то, что агент запускает
├── references/       # то, что он читает при необходимости
└── assets/           # шаблоны, картинки, файлы

Заголовок минимально содержит name и description. По желанию добавляются allowed-tools (какими инструментами навыку разрешено пользоваться) и model. Описание тут — не украшение: именно по нему агент решает, доставать навык из папки или нет.

Ключевая идея — подпапки открываются лениво. Агент держит в голове только заголовок и короткое описание, а тяжелые справочники и скрипты подтягивает, когда инструкция прямо это велит. Поэтому десяток навыков не съедает контекст просто фактом своего существования.

Чем это отличается от AGENTS.md

Их постоянно путают, хотя роли разные. AGENTS.md — это правила репозитория, которые действуют всегда: как здесь принято называть коммиты, куда складывать тесты, чего не трогать. Агент читает их в начале работы и держит фоном.

SKILL.md — это одна повторяемая работа: выкатить релиз, разобрать логи, собрать отчет. Она подключается, когда пришло время ее делать, и не мешает все остальное время.

Сложившаяся к 2026 году раскладка выглядит так:

AGENTS.md — постоянные правила проекта;
SKILL.md — конкретная повторяемая задача;
MCP — живые данные и действия во внешних системах;
плагины — когда наработанное надо раздать другим командам.

Практическое следствие: если тянет запихнуть в AGENTS.md пошаговую инструкцию на две страницы — это признак, что перед вами навык, а не правило. Правила короткие и общие, инструкции длинные и ситуативные.

gh skill: навыки как пакеты

В апреле GitHub выпустил в публичное превью команду gh skill — по сути пакетный менеджер для навыков. Ставится из репозитория по имени, тегу или конкретному коммиту:

gh skill install github/awesome-copilot documentation-writer

Работает поверх Copilot, Claude Code, Cursor, Codex и Gemini CLI — то есть навык, выложенный один раз, ставится в любой из них одной строкой. Это тот момент, когда формат из «удобного соглашения» превратился в инфраструктуру: появилась установка, версии и возможность закрепиться на конкретной ревизии.

Где подвох

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

Поэтому минимальная гигиена: смотреть, что лежит в scripts/, закреплять версию коммитом, а не веткой, и ограничивать allowed-tools тем, что навыку действительно нужно. Особенно если он умеет ходить в сеть или писать в файловую систему.

Что это меняет на практике

Главное изменение не техническое, а организационное. Раньше знание о том, «как у нас принято выкатывать», жило в голове у двоих и в переписке. Теперь оно лежит в репозитории отдельным файлом, версионируется вместе с кодом и работает одинаково у всех — независимо от того, кто каким агентом пользуется.

А выбор инструмента наконец перестал быть выбором на годы вперед. Переход с одного агента на другой больше не означает, что придется переносить всю накопленную обвязку руками.