Что такое Agent Skills: как устроен формат SKILL.md, который Anthropic передала Linux Foundation, и где он работает (октябрь 2026)

Поля, папки и три стадии загрузки — по спецификации agentskills.io, цифры — из анонса Anthropic от 22 октября 2026 года.

22 октября 2026 года Anthropic передала стандарт Agent Skills фонду Agentic AI Foundation (AAIF), который работает под эгидой Linux Foundation. Вместе со стандартом фонд получил название и логотип, организацию на GitHub и домен agentskills.io. Пользоваться стандартом и участвовать в его развитии можно без вступления в фонд.

AAIF Anthropic основала в 2025 году вместе с Block и OpenAI, туда же ранее перешёл Model Context Protocol. По словам компании, фонд станет нейтральным домом для стандарта. Ведущими сопровождающими назначены David Soria Parra и Mahesh Murag, а инженеры Anthropic, Google, OpenAI и других компаний будут участвовать как частные лица, а не представители компаний.

Цифры из анонса: более 70 агентских платформ интегрировали Agent Skills, включая ChatGPT, Cursor, GitHub Copilot и VS Code; опубликовано 1 млн скиллов, установлено почти 280 млн раз. По словам Anthropic, скиллы компания разработала в работе над Claude Code: он хорошо справлялся с общими задачами, но ему не хватало процедурных знаний — как именно в компании делают конкретную работу. Стандарт опубликовали в декабре 2025 года.

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

skill-name/ ├── SKILL.md # Required: metadata + instructions ├── scripts/ # Optional: executable code ├── references/ # Optional: documentation ├── assets/ # Optional: templates, resources └── ... # Any additional files or directories

scripts/ — исполняемый код: Python, Bash, JavaScript. Какие языки поддерживаются, решает конкретный агент.
references/ — дополнительная документация, которую агент читает по необходимости. Спецификация советует делать файлы небольшими: меньше файл — меньше места в контексте.
assets/ — статичные ресурсы: шаблоны документов, картинки, таблицы соответствий, схемы.

SKILL.md начинается с YAML-блока, дальше идёт Markdown с инструкциями. Минимальный пример из спецификации:

--- name: skill-name description: A description of what this skill does and when to use it. ---

name (обязательно) — до 64 символов: строчные буквы, цифры и дефисы. Не может начинаться или заканчиваться дефисом, содержать два дефиса подряд и должно совпадать с именем папки.
description (обязательно) — до 1024 символов. Описывает, что скилл делает и когда его применять. Спецификация приводит пример плохого описания — «Helps with PDFs.» — и хорошего, с перечнем задач и ключевых слов.
license — название лицензии или файл с её текстом.
compatibility — до 500 символов о требованиях к окружению: нужные пакеты, доступ к сети, целевой продукт. Нужно не всем скиллам.
metadata — произвольные пары «ключ — строка», например автор и версия. Для ключей советуют выбирать имена, которые вряд ли совпадут с чужими.
allowed-tools — список заранее разрешённых инструментов через пробел, например Bash(git:*) Bash(jq:*) Read. Поле экспериментальное, поддержка у агентов разная.

Тело файла без ограничений по формату. В спецификации указаны пошаговые инструкции, примеры входа и выхода и разбор частых ошибок.

Идея формата — прогрессивное раскрытие: агент берёт ровно столько, сколько нужно задаче. Спецификация описывает три стадии:

Метаданные, около 100 токенов: поля name и description всех установленных скиллов загружаются при старте.
Инструкции, по спецификации меньше 5000 токенов: тело SKILL.md читается целиком, когда агент решил применить скилл.
Ресурсы по необходимости: файлы из scripts/, references/ и assets/ открываются, только когда на них ссылается инструкция.

Отсюда практические ограничения из той же спецификации: основной SKILL.md — не длиннее 500 строк, подробности — в отдельных файлах, ссылки на них — относительные пути от корня скилла и на один уровень вглубь, без цепочек вложенных ссылок.

Для валидации в репозитории стандарта есть библиотека skills-ref. Она проверяет, что frontmatter корректен и имена соответствуют правилам. По README, её ставят из папки skills-ref клонированного репозитория командой pip install -e . в виртуальном окружении, а ещё в README сказано, что библиотека демонстрационная и не предназначена для продакшена. Команда проверки:

skills-ref validate ./my-skill

Claude Code поддерживает все шесть полей стандарта и добавляет свои: when_to_use, argument-hint, arguments, disable-model-invocation, user-invocable, disallowed-tools, model, effort, context, agent, background, hooks, paths, shell. Если упаковать скилл с такими ключами для claude.ai или Skills API, будет ошибка «Unexpected key(s)»; сам Claude Code неизвестные ключи молча игнорирует.

Где лежат скиллы в Claude Code:

личные — ~/.claude/skills//SKILL.md, доступны во всех проектах;
проектные — .claude/skills//SKILL.md, их можно коммитить в репозиторий для команды;
вложенные — /.claude/skills/, работают для сессий в этой папке и ниже;
плагинные — /skills//SKILL.md, вызываются как /plugin-name:skill-name.

Запустить скилл можно вручную командой /skill-name с аргументами после неё или дождаться, пока Claude сам загрузит его по совпадению с description. В списке скиллов в контексте описания обрезаются на 1536 символах, поэтому главное применение стоит писать первым. С disable-model-invocation: true описание вообще не попадает в контекст, и скилл запускается только вручную.

В анонсе предложена дорожная карта: версионированные релизы спецификации, формальный процесс предложений и рекомендации по безопасности для авторов и тех, кто устанавливает скиллы. Обратную связь по изменениям собирают в Discord-сообществе проекта; спецификация и репозиторий — на agentskills.io и github.com/agentskills/agentskills.

name + description — единственное, что агент знает о скилле заранее (~100 токенов).
Тело SKILL.md — загружается при запуске, до 5000 токенов и 500 строк.
scripts/, references/, assets/ — читаются по ссылкам, когда нужны.
Поля Claude Code (context, hooks, model и другие) — не переносятся в claude.ai и API.