Agent Skills: стандарт, формат SKILL.md и интеграция в Claude Code после передачи в Linux Foundation

TopG 25 октября 2026 5 минут

22 октября 2026 года компания Anthropic передала стандарт Agent Skills фонду Agentic AI Foundation (AAIF), который функционирует под эгидой Linux Foundation. Вместе со спецификацией фонд получил название, логотип, организацию на GitHub и домен agentskills.io. Участие в развитии стандарта не требует вступления в фонд — спецификация открыта для всех. AAIF была создана в 2025 году совместно Anthropic, Block и OpenAI; ранее в неё перешёл стандарт Model Context Protocol. Ведущими сопровождающими назначены David Soria Parra и Mahesh Murag, а инженеры Anthropic, Google, OpenAI и других компаний участвуют как частные лица.

Ключевые показатели внедрения

По данным анонса Anthropic, на момент передачи стандарта более 70 агентских платформ интегрировали Agent Skills, среди них ChatGPT, Cursor, GitHub Copilot и VS Code. Опубликовано около 1 миллиона скиллов, общее число установок приблизилось к 280 миллионам. По словам компании, стандарт возник в ходе работы над 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/

Хранит статичные ресурсы: шаблоны документов, изображения, таблицы соответствий, схемы. Файлы из этой папки не выполняются, а используются как справочные материалы.

Frontmatter SKILL.md: поля и правила валидации

Файл

SKILL.md

начинается с YAML-блока (frontmatter), за которым следует 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
```
. Поле экспериментальное, поддержка у агентов разная.

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

Прогрессивная загрузка: три стадии

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

1. Метаданные (~100 токенов)

При старте агента загружаются поля

name

description

всех установленных скиллов. Это единственная информация, доступная агенту до явного вызова скилла.

2. Инструкции (<5000 токенов)

Тело

SKILL.md

читается целиком, когда агент решил применить скилл. Спецификация рекомендует ограничивать основной файл 500 строками, вынося подробности в отдельные файлы.

3. Ресурсы по необходимости

Файлы из

scripts/

references/

assets/

открываются только когда на них ссылается инструкция в теле

SKILL.md

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

Валидация через skills-ref

Для проверки соответствия спецификации в репозитории стандарта предоставляется библиотека

skills-ref

. Она валидирует корректность frontmatter и соблюдение правил именования.

Установка выполняется из папки

skills-ref

клонированного репозитория:

pip install -e .

Рекомендуется использовать виртуальное окружение. В README библиотеки указано, что она демонстрационная и не предназначена для продакшена. Команда проверки:

skills-ref validate ./my-skill

Реализация в Claude Code

Claude Code поддерживает все шесть стандартных полей спецификации и добавляет собственные расширения.

Расширения Anthropic

Дополнительные ключи, распознаваемые только 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/skills/<name>/SKILL.md
```
, доступны во всех проектах пользователя.
Проектные —
```
.claude/skills/<name>/SKILL.md
```
, коммитятся в репозиторий для команды.
Вложенные —
```
<path>/.claude/skills/
```
, работают для сессий в этой папке и ниже.
Плагинные —
```
/skills/<name>/SKILL.md
```
, вызываются как
```
/plugin-name:skill-name
```
.

Способы вызова и нюансы контекста

Запуск вручную: команда

/skill-name

с аргументами после неё. Автоматический: Claude загружает скилл по совпадению с

description

В списке скиллов в контексте описания обрезаются на 1536 символах — поэтому основное применение стоит писать в начале

description

. При

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.

Поиск