Изучаем структуру SKILL.md и сопутствующих файлов
В июле 2026 ArXiv опубликовал разбор структуры Agent Skills: каждый навык — это архив или директория с обязательным файлом SKILL.md. В этом файле описываются назначение, параметры запуска, инструкции для агента и ограничения по использованию. Дополнительно могут присутствовать вспомогательные файлы: скрипты, тесты, примеры данных, зависимости для MCP или SDK.
SKILL.md играет роль паспорта навыка — в нём указывают краткое описание, ключевые шаги, входные и выходные параметры, а также условия активации. Если навык использует внешние ресурсы или инструменты, эти связи тоже прописываются здесь. Для загрузки навык обычно архивируют (например, в ZIP), чтобы его структура сохранилась при трансфере через CLI или API.
- Обычно структура навыка выглядит так:
SKILL.md(описание и инструкции)helpers.pyилиhelpers.ts(скрипты)- tests/ (тесты)
- data/ (пример входных данных)
💡 Аналогия
Структура Agent Skill похожа на коробку с инструкцией по сборке: SKILL.md — это сама инструкция, а дополнительные файлы — детали и инструменты для сборки.
Ключевые моменты
Основной файл любого навыка — SKILL.md с описанием, шагами и условиями активации.
Вспомогательные файлы расширяют функциональность навыка (скрипты, тесты, примеры).
Навык архивируют для удобства загрузки через CLI или API.
Следующий урок
Сравниваем skills, инструменты и CLAUDE.md
Теория